implement update train details feature: add DTO, service method, and UI modal for editing train name and run numbers

apps/edr-freight-web/backoffice/src/services/api.ts

@@ -191,6 +191,7 @@ import {
   type BuiltTrainListResponse,
   type ScheduleConsist,
   type TrainComposition,
+  type UpdateTrainDetailsPayload,
 } from "./trainBuilder.service";
 import { trainSchedulingService } from "./trainScheduling.service";
 import { wagonTypesService, type WagonType } from "./wagon-types.service";
@@ -1842,6 +1843,18 @@ export const api = {
       () => TRAIN_BUILDER_INVALIDATIONS,
     ),
 
+    updateDetails: endpoint<
+      { id: string; payload: UpdateTrainDetailsPayload },
+      TrainComposition
+    >(
+      "train-builder",
+      "updateDetails",
+      ({ id, payload }) =>
+        trainBuilderService.updateDetails(id, payload).then((r) => r.data),
+      undefined,
+      () => TRAIN_BUILDER_INVALIDATIONS,
+    ),
+
     assignWagons: endpoint<{ id: string; wagonIds: string[] }, TrainComposition>(
       "train-builder",
       "assignWagons",

apps/edr-freight-web/backoffice/src/services/trainBuilder.service.ts

@@ -140,6 +140,14 @@ export interface BuildTrainPayload {
   notes?: string;
 }
 
+/** Edit a built train's display identity; omitted fields keep their value. */
+export interface UpdateTrainDetailsPayload {
+  /** Empty string clears the name. */
+  trainName?: string;
+  importTrainNumber?: string;
+  exportTrainNumber?: string;
+}
+
 /** Built train annotated for the schedule-creation picker. */
 export interface AvailableTrain {
   id: string;
@@ -241,6 +249,9 @@ export const trainBuilderService = {
   build: (payload: BuildTrainPayload) => apiClient.post<TrainComposition>(BASE, payload),
   setLocomotives: (id: string, locomotiveIds: string[]) =>
     apiClient.put<TrainComposition>(`${BASE}/${id}/locomotives`, { locomotiveIds }),
+  /** Edit the train's name and fixed import/export run numbers. */
+  updateDetails: (id: string, payload: UpdateTrainDetailsPayload) =>
+    apiClient.patch<TrainComposition>(`${BASE}/${id}/details`, payload),
   /** Relocate the train — coupled locomotives and wagons move with it. */
   setYard: (id: string, currentYardId: string) =>
     apiClient.patch<TrainComposition>(`${BASE}/${id}/yard`, { currentYardId }),