Changes between Version 10 and Version 11 of UseCaseImplementation

Timestamp:

02/17/25 13:57:33 (5 days ago)

Author:

222077

Comment:

--

UseCaseImplementation

@@ -9 +9 @@
 ||6||||'''[wiki:RegisterUseCase Register]'''||
 
-=== **ID 1** - Search Routes
+== **ID 1** - Search Routes
 The `/search-routes` endpoint provides users with the ability to search for available transport routes from different organizers. 
 It supports both **viewing all routes** by default and **filtering routes** based on user input (departure and arrival locations). 
@@ -68 +68 @@
 
 === 
-=== **ID 2** - Organize Trip
+== **ID 2** - Organize Trip
 The `/routes` endpoint provides transport organizers with the ability to manage their routes and organize trips. 
 It supports **viewing authorized routes**, **viewing trips for a specific route**, and **adding new trips**. 
@@ -194 +194 @@
 [[Image(add-trip-success.png, 100%)]]
 === 
+
+== **ID 3** - Manage Trip
+The `/routes` endpoint allows transport organizers to manage their trips. It includes the ability to **view, add, edit, and delete trips** for their authorized routes.
+
+Here is an example of the flow to manage trips:
+- View routes: `/routes/company`
+- View trips for a specific route: `/routes/company/view-trips/{routeId}`
+- Add a new trip: `/routes/company/view-trips/{routeId}/add-trip`
+- Edit an existing trip: `/routes/company/view-trips/{routeId}/edit-trip/{tripId}`
+- Delete a trip: `/routes/company/view-trips/{routeId}/delete-trip/{tripId}`
+
+=== 
+{{{
+    @RequestMapping("/routes")
+    public class CompanyRouteController {
+        private final CompanyRouteService companyRouteService;
+
+        public CompanyRouteController(CompanyRouteService companyRouteService) {
+            this.companyRouteService = companyRouteService;
+        }
+
+        @GetMapping("/company")
+        public String routes(Model model) {
+            model.addAttribute("companyRoutes", companyRouteService.getAuthorizedRoutes());
+            model.addAttribute("display", "/company/company-route");
+
+            return "master";
+        }
+    }
+}}}
+
+=== 
+{{{
+    @RequestMapping("/routes/company/view-trips/{routeId}")
+    public class CompanyTripController {
+        private final CompanyTripService companyTripService;
+        private final RouteService routeService;
+        private final LocationService locationService;
+
+        public CompanyTripController(CompanyTripService companyTripService, RouteService routeService, LocationService locationService) {
+            this.companyTripService = companyTripService;
+            this.routeService = routeService;
+            this.locationService = locationService;
+        }
+
+        @GetMapping
+        public String routeTrips(@PathVariable Integer routeId, Model model) {
+            Route route = routeService.findById(routeId);
+
+            model.addAttribute("trips", companyTripService.getAuthorizedTripsByRoute(routeId));
+            model.addAttribute("routeId", routeId);
+            model.addAttribute("locations", locationService.findAll());
+            model.addAttribute("routeSource", route.getSource());
+            model.addAttribute("routeDestination", route.getDestination());
+            model.addAttribute("display", "/company/company-view-trip");
+
+            return "master";
+        }
+
+        @PostMapping("/add-trip")
+        public String addNewTrip(@PathVariable Integer routeId,
+                                 @RequestParam("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
+                                 @RequestParam("freeSeats") int freeSeats,
+                                 @RequestParam("locations") List<Integer> locationIds,
+                                 @RequestParam("etas") @DateTimeFormat(pattern = "HH:mm") List<LocalTime> etas,
+                                 RedirectAttributes redirectAttributes) {
+
+            try {
+                Route route = routeService.findById(routeId);
+                companyTripService.createTrip(route, date, freeSeats, locationIds, etas);
+                redirectAttributes.addFlashAttribute("message", "Trip created successfully!");
+            } catch (IllegalArgumentException | SecurityException e) {
+                redirectAttributes.addFlashAttribute("error", e.getMessage());
+            }
+            return "redirect:/routes/company/view-trips/" + routeId;
+        }
+
+        @PostMapping("/edit-trip/{tripId}")
+        public String editTrip(@PathVariable Integer routeId,
+                               @PathVariable Integer tripId,
+                               @RequestParam("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
+                               @RequestParam("freeSeats") int freeSeats,
+                               @RequestParam("locations") List<Integer> locationIds,
+                               @RequestParam("etas") @DateTimeFormat(pattern = "HH:mm") List<LocalTime> etas,
+                               RedirectAttributes redirectAttributes) {
+            try {
+                Route route = routeService.findById(routeId);
+                companyTripService.updateTrip(route, tripId, date, freeSeats, locationIds, etas);
+                redirectAttributes.addFlashAttribute("message", "Trip updated successfully!");
+            } catch (IllegalArgumentException | SecurityException e) {
+                redirectAttributes.addFlashAttribute("error", e.getMessage());
+            }
+            return "redirect:/routes/company/view-trips/" + routeId;
+        }
+
+        @PostMapping("/delete-trip/{tripId}")
+        public String deleteTrip(@PathVariable Integer routeId, @PathVariable Integer tripId) {
+            return companyTripService.deleteTripIfAuthorized(tripId)
+                    ? "redirect:/routes/company/view-trips/" + routeId
+                    : "redirect:/";
+        }
+    }
+}}}
+
+=== 
+==== Controller Details for Routes:
+- **URL Mapping:** `/routes/company`
+- **Method:** `GET`
+- **Functionality:** Displays all **authorized routes** for the transport organizer.
+- **View:** Uses the `master` template and dynamically embeds `/company/company-route`.
+
+==== Breakdown:
+- Displays a list of all routes that the transport organizer is authorized to manage.
+- Retrieves authorized routes from the `CompanyRouteService` and populates them into the `Model`.
+- The view is displayed using `/company/company-route`.
+
+
+=== 
+
+==== Controller Details for Trips:
+- **URL Mapping:** `/routes/company/view-trips/{routeId}`
+- **Method:** `GET`, `POST`
+- **Functionality:**
+  - **GET `/routes/company/view-trips/{routeId}`**: Displays **all trips** for the selected route.
+  - **POST `/routes/company/view-trips/{routeId}/add-trip`**: Allows the transport organizer to **add a new trip**.
+  - **POST `/routes/company/view-trips/{routeId}/edit-trip/{tripId}`**: Allows the transport organizer to **edit an existing trip**.
+  - **POST `/routes/company/view-trips/{routeId}/delete-trip/{tripId}`**: Allows the transport organizer to **delete a trip**.
+- **View:** Uses the `master` template and dynamically embeds `/company/company-view-trip`.
+
+==== Breakdown:
+- **Viewing trips**: When the transport organizer accesses `/routes/company/view-trips/{routeId}`, the controller retrieves all trips for the specified route using `companyTripService.getAuthorizedTripsByRoute(routeId)`.
+- **Adding a new trip**: A form allows the transport organizer to specify the date, free seats, locations, and ETAs for the trip. The controller calls `companyTripService.createTrip()` to create a new trip.
+- **Editing a trip**: The transport organizer can modify trip details. The controller calls `companyTripService.updateTrip()` to update the trip.
+- **Deleting a trip**: The transport organizer can delete a trip. The controller calls `companyTripService.deleteTripIfAuthorized()` to remove the trip if the organizer is authorized.
+- **Viewing trip stops trip** The transport organizer can view and modify trip stops. The controller calls companyTripService.updateTrip() to update whatever the authorized transport organizer wants.
+
+=== 
+
+==== Edit Trip:
+===== **Free seats modified:**
+[[Image(edit-trip.png, 100%)]]
+[[Image(edited-trip.png, 100%)]]
+
+==== Delete Trip:
+[[Image(delete-trip.png, 100%)]]
+
+=== 
+=== Trip Stops:
+[[Image(trip-stops.png, 100%)]]
+=== 
+