[UBS Address] User can choose districts on own

core/src/main/java/greencity/configuration/SecurityConfig.java

@@ -229,6 +229,10 @@ protected void configure(HttpSecurity http) throws Exception {
                 UBS_LINK + "/userProfile/**",
                 UBS_LINK + "/update-order-address")
             .hasAnyRole(USER, ADMIN)
+            .antMatchers(HttpMethod.GET,
+                UBS_LINK + "/userProfile/**",
+                UBS_LINK + "/get-all-districts")
+            .hasAnyRole(USER, ADMIN)
             .antMatchers(HttpMethod.PATCH,
                 UBS_LINK + "/userProfile/**",
                 UBS_LINK + "/client/**",

core/src/main/java/greencity/controller/AddressController.java

@@ -4,9 +4,12 @@
 import greencity.constants.HttpStatuses;
 import greencity.dto.CreateAddressRequestDto;
 import greencity.dto.address.AddressDto;
+import greencity.dto.location.api.LocationDto;
 import greencity.dto.order.OrderAddressDtoRequest;
+import greencity.dto.order.OrderCancellationReasonDto;
 import greencity.dto.order.OrderWithAddressesResponseDto;
 import greencity.dto.user.UserVO;
+import greencity.service.locations.LocationApiService;
 import greencity.service.ubs.UBSClientService;
 import io.swagger.annotations.ApiOperation;
 import io.swagger.annotations.ApiResponse;
@@ -15,26 +18,29 @@
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.validation.annotation.Validated;
-import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PatchMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.PutMapping;
-import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.ResponseStatus;
 import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import springfox.documentation.annotations.ApiIgnore;
 
 import javax.validation.Valid;
+import java.util.List;
 
 @RestController
 @RequestMapping("/ubs")
 @Validated
 @RequiredArgsConstructor
 public class AddressController {
     private final UBSClientService ubsClientService;
+    private final LocationApiService locationApiService;
 
     /**
      * Controller for getting all addresses for current order.
@@ -144,4 +150,27 @@ public ResponseEntity<AddressDto> makeAddressActual(
         return ResponseEntity.status(HttpStatus.OK)
             .body(ubsClientService.makeAddressActual(addressId, uuid));
     }
+
+    /**
+     * Controller to get all districts for a given region and city.
+     *
+     * @param region Name of the region.
+     * @param city   Name of the city.
+     * @return A List of LocationDtos containing a list of all districts for the
+     *         specified region and city.
+     */
+    @ApiOperation(value = "Get all districts for a given region and city",
+        notes = "Provide a region and a city to look up for associated districts")
+    @ApiResponses(value = {
+        @ApiResponse(code = 200, message = HttpStatuses.OK, response = OrderCancellationReasonDto.class),
+        @ApiResponse(code = 401, message = HttpStatuses.UNAUTHORIZED),
+        @ApiResponse(code = 403, message = HttpStatuses.FORBIDDEN),
+        @ApiResponse(code = 404, message = HttpStatuses.NOT_FOUND)
+    })
+    @GetMapping("/get-all-districts")
+    public ResponseEntity<List<LocationDto>> getAllDistrictsForRegionAndCity(@RequestParam String region,
+        @RequestParam String city) {
+        return ResponseEntity.status(HttpStatus.OK)
+            .body(locationApiService.getAllDistrictsInCityByNames(region, city));
+    }
 }

core/src/test/java/greencity/controller/AddressControllerTest.java

@@ -6,7 +6,9 @@
 import greencity.configuration.SecurityConfig;
 import greencity.converters.UserArgumentResolver;
 import greencity.dto.CreateAddressRequestDto;
+import greencity.dto.location.api.LocationDto;
 import greencity.dto.order.OrderAddressDtoRequest;
+import greencity.service.locations.LocationApiService;
 import greencity.service.ubs.UBSClientService;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -21,6 +23,10 @@
 import org.springframework.test.web.servlet.setup.MockMvcBuilders;
 
 import java.security.Principal;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 
 import static greencity.ModelUtils.getPrincipal;
 import static org.mockito.ArgumentMatchers.any;
@@ -46,6 +52,9 @@ class AddressControllerTest {
     @Mock
     private UBSClientService ubsClientService;
 
+    @Mock
+    private LocationApiService locationApiService;
+
     @Mock
     private UserRemoteClient userRemoteClient;
 
@@ -128,4 +137,29 @@ void makeAddressActual() throws Exception {
 
         verify(ubsClientService).makeAddressActual(addressId, uuid);
     }
+
+    @Test
+    void getAllDistrictsForRegionAndCity() throws Exception {
+        String region = "Львівська";
+        String city = "Львів";
+        Map<String, String> nameMap = new HashMap<>();
+        nameMap.put("name", "Львів");
+        nameMap.put("nameEn", "Lviv");
+        List<LocationDto> mockLocationDtoList = new ArrayList<>();
+        LocationDto mockLocationDto = LocationDto.builder()
+            .id("UA46060250010015970")
+            .parentId("UA46060250000025047")
+            .locationNameMap(nameMap)
+            .build();
+        when(locationApiService.getAllDistrictsInCityByNames(region, city)).thenReturn(mockLocationDtoList);
+        mockMvc.perform(get(ubsLink + "/get-all-districts")
+            .param("region", region)
+            .param("city", city)
+            .principal(principal)
+            .contentType(MediaType.APPLICATION_JSON))
+            .andExpect(status().isOk());
+
+        verify(locationApiService).getAllDistrictsInCityByNames(region, city);
+    }
+
 }

dao/src/main/java/greencity/enums/LocationDivision.java

@@ -0,0 +1,55 @@
+package greencity.enums;
+
+/**
+ * Enum for representing various location divisions. Each enum instance
+ * represents a different level of division, with an associated level ID
+ */
+public enum LocationDivision {
+    /**
+     * Represents a region or autonomous republic.
+     */
+    REGION(1),
+
+    /**
+     * Represents a district within a region or autonomous republic.
+     */
+    DISTRICT_IN_REGION(2),
+
+    /**
+     * Represents a local community.
+     */
+    LOCAL_COMMUNITY(3),
+
+    /**
+     * Represents a city or village.
+     */
+    CITY(4),
+
+    /**
+     * Represents a district within a city.
+     */
+    DISTRICT_IN_CITY(5);
+
+    /**
+     * ID for the location division level.
+     */
+    int levelId;
+
+    /**
+     * Constructor for creating a location division instance.
+     *
+     * @param levelId The ID for the location division level.
+     */
+    LocationDivision(int levelId) {
+        this.levelId = levelId;
+    }
+
+    /**
+     * Returns the ID for the location division level.
+     *
+     * @return The ID for the location division level.
+     */
+    public int getLevelId() {
+        return levelId;
+    }
+}

dao/src/test/java/greencity/enums/LocationDivisionTest.java

@@ -0,0 +1,32 @@
+package greencity.enums;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+class LocationDivisionTest {
+
+    @Test
+    void testRegionLevelId() {
+        Assertions.assertEquals(1, LocationDivision.REGION.getLevelId());
+    }
+
+    @Test
+    void testDistrictInRegionLevelId() {
+        Assertions.assertEquals(2, LocationDivision.DISTRICT_IN_REGION.getLevelId());
+    }
+
+    @Test
+    void testLocalCommunityLevelId() {
+        Assertions.assertEquals(3, LocationDivision.LOCAL_COMMUNITY.getLevelId());
+    }
+
+    @Test
+    void testCityLevelId() {
+        Assertions.assertEquals(4, LocationDivision.CITY.getLevelId());
+    }
+
+    @Test
+    void testDistrictInCityLevelId() {
+        Assertions.assertEquals(5, LocationDivision.DISTRICT_IN_CITY.getLevelId());
+    }
+}

service-api/src/main/java/greencity/constant/ErrorMessage.java

@@ -53,6 +53,13 @@ public final class ErrorMessage {
     public static final String PAYMENT_NOT_FOUND = "Payment not found for order id: ";
     public static final String ADDRESS_ALREADY_EXISTS = "Address already exists";
     public static final String ADDRESS_NOT_FOUND = "Address not found";
+    public static final String NOT_FOUND_LOCATION_ON_LEVEL_AND_BY_CODE =
+        "Not found locations on level: %s, and by code: %s";
+    public static final String VALUE_CAN_NOT_BE_NULL_OR_EMPTY = "The value parameter cannot be null or empty";
+    public static final String NOT_FOUND_LOCATION_BY_URL = "Not found locations by url: ";
+    public static final String REGION_NOT_FOUND = "Region not found: ";
+    public static final String CITY_NOT_FOUND = "City not found: ";
+    public static final String CITY_NOT_FOUND_IN_REGION = "City not found in region: ";
     public static final String ACTUAL_ADDRESS_NOT_FOUND = "Actual address not found";
     public static final String LOCATION_DOESNT_FOUND_BY_ID = "Location does not exist by id: ";
     public static final String LOCATIONS_BELONG_TO_DIFFERENT_REGIONS =
@@ -153,6 +160,7 @@ public final class ErrorMessage {
     public static final String REGIONS_NOT_FOUND_BY_LOCATION_STATUS =
         "Regions containing locations with a status: %s, not found";
     public static final String ORDER_CAN_NOT_BE_UPDATED = "An order with the status: %s, can not be updated";
+    public static final String INVALID_URL = "Invalid URL: ";
     public static final String LOCATION_CAN_NOT_BE_DELETED =
         "Such location cannot be deleted as it is linked to the tariff";
 

service-api/src/main/java/greencity/dto/location/api/LocationDto.java

@@ -0,0 +1,14 @@
+package greencity.dto.location.api;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.Map;
+
+@Data
+@Builder
+public class LocationDto {
+    private String parentId;
+    private String id;
+    private Map<String, String> locationNameMap;
+}