feat(random_user): add random user API (#58)

* feat(random_user): add random user API

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: MayuriXx

README.md

@@ -83,7 +83,7 @@ dummy.api.base-url=https://dummyjson.com/
 
 | Method | Path                     | Description | Status |
 |--------|--------------------------|-------------|--------|
-| `GET` | `/random-users?count=30` | Fetch and save users from external API | ✅ |
+| `GET` | `/random-users?page=1&size=10&source=DUMMY` | Fetch and save users from selected external API source | ✅ |
 | `GET` | `/random-users/{id}`     | Get user by ID | ✅ |
 | `POST` | `/random-users`          | Create a new user | ✅ |
 | `PUT` | `/random-users/{id}`     | Update user | ✅ |
@@ -93,7 +93,10 @@ dummy.api.base-url=https://dummyjson.com/
 
 ```bash
 # Fetch 10 users from external API and store them
-curl -X GET "http://localhost:8080/random-users?count=10"
+curl -X GET "http://localhost:8080/random-users?page=1&size=10&source=DUMMY"
+
+# Fetch 10 users from randomuser.me and store them
+curl -X GET "http://localhost:8080/random-users?page=1&size=10&source=RANDOM_USER"
 
 # Get user by ID
 curl -X GET "http://localhost:8080/random-users/1"
@@ -185,6 +188,8 @@ curl -X PUT "http://localhost:8080/random-users/1" \
 
 - `DummyUserApi`: Retrofit client contract for DummyJSON endpoints.
 - `DummyUserServiceImpl`: adapter that calls `DummyUserApi`, maps DTOs, and returns `PaginatedUsers`.
+- `RandomUserApi`: Retrofit client contract for randomuser.me endpoints.
+- `RandomUserServiceImpl`: adapter that calls `RandomUserApi`, maps DTOs, and returns `PaginatedUsers`.
 
 ### Project Structure
 

src/main/java/com/xpeho/spring_boot_java_random_user/data/converters/UserConverter.java

@@ -1,7 +1,8 @@
 package com.xpeho.spring_boot_java_random_user.data.converters;
 
 import com.xpeho.spring_boot_java_random_user.data.models.api.dummy.DummyUserResultDTO;
-import com.xpeho.spring_boot_java_random_user.data.models.db.User;
+import com.xpeho.spring_boot_java_random_user.data.models.api.randomuser.RandomUserResultDTO;
+import com.xpeho.spring_boot_java_random_user.data.models.database.User;
 import com.xpeho.spring_boot_java_random_user.domain.entities.UserEntity;
 import org.springframework.stereotype.Service;
 
@@ -52,4 +53,24 @@ public UserEntity fromApiModel(DummyUserResultDTO model) {
                 null
         );
     }
+
+    // RandomUser API DTO -> Domain
+    public UserEntity fromRandomUserApiModel(RandomUserResultDTO model) {
+        String title = model.getName() != null ? model.getName().getTitle() : null;
+        String first = model.getName() != null ? model.getName().getFirst() : null;
+        String last = model.getName() != null ? model.getName().getLast() : null;
+        String picture = model.getPicture() != null ? model.getPicture().getMedium() : null;
+
+        return new UserEntity(
+                null,
+                model.getGender(),
+                first,
+                last,
+                title,
+                model.getEmail(),
+                model.getPhone(),
+                picture,
+                model.getNat()
+        );
+    }
 }

…a/models/api/dummy/DummyUserNameDTO.java …ls/api/randomuser/RandomUserNameDTO.javasrc/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/dummy/DummyUserNameDTO.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserNameDTO.java src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/dummy/DummyUserNameDTO.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserNameDTO.java

@@ -1,6 +1,6 @@
-package com.xpeho.spring_boot_java_random_user.data.models.api.dummy;
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
 
-public class DummyUserNameDTO {
+public class RandomUserNameDTO {
     private String title;
     private String first;
     private String last;

…odels/api/dummy/DummyUserPictureDTO.java …api/randomuser/RandomUserPictureDTO.javasrc/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/dummy/DummyUserPictureDTO.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserPictureDTO.java src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/dummy/DummyUserPictureDTO.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserPictureDTO.java

@@ -1,6 +1,6 @@
-package com.xpeho.spring_boot_java_random_user.data.models.api.dummy;
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
 
-public class DummyUserPictureDTO {
+public class RandomUserPictureDTO {
     private String medium;
 
     public String getMedium() {

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserResponseDTO.java

@@ -0,0 +1,16 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+import java.util.List;
+
+public class RandomUserResponseDTO {
+    private List<RandomUserResultDTO> results;
+
+    public List<RandomUserResultDTO> getResults() {
+        return results;
+    }
+
+    public void setResults(List<RandomUserResultDTO> results) {
+        this.results = results;
+    }
+}
+

src/main/java/com/xpeho/spring_boot_java_random_user/data/models/api/randomuser/RandomUserResultDTO.java

@@ -0,0 +1,59 @@
+package com.xpeho.spring_boot_java_random_user.data.models.api.randomuser;
+
+public class RandomUserResultDTO {
+    private String gender;
+    private RandomUserNameDTO name;
+    private String email;
+    private String phone;
+    private RandomUserPictureDTO picture;
+    private String nat;
+
+    public String getGender() {
+        return gender;
+    }
+
+    public void setGender(String gender) {
+        this.gender = gender;
+    }
+
+    public RandomUserNameDTO getName() {
+        return name;
+    }
+
+    public void setName(RandomUserNameDTO name) {
+        this.name = name;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public String getPhone() {
+        return phone;
+    }
+
+    public void setPhone(String phone) {
+        this.phone = phone;
+    }
+
+    public RandomUserPictureDTO getPicture() {
+        return picture;
+    }
+
+    public void setPicture(RandomUserPictureDTO picture) {
+        this.picture = picture;
+    }
+
+    public String getNat() {
+        return nat;
+    }
+
+    public void setNat(String nat) {
+        this.nat = nat;
+    }
+}
+

…ava_random_user/data/models/db/User.java …ndom_user/data/models/database/User.javasrc/main/java/com/xpeho/spring_boot_java_random_user/data/models/db/User.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/database/User.java src/main/java/com/xpeho/spring_boot_java_random_user/data/models/db/User.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/models/database/User.java

@@ -1,4 +1,4 @@
-package com.xpeho.spring_boot_java_random_user.data.models.db;
+package com.xpeho.spring_boot_java_random_user.data.models.database;
 
 import org.springframework.data.annotation.Id;
 import org.springframework.data.relational.core.mapping.Column;

src/main/java/com/xpeho/spring_boot_java_random_user/data/services/UserServiceImpl.java

@@ -1,7 +1,7 @@
 package com.xpeho.spring_boot_java_random_user.data.services;
 
 import com.xpeho.spring_boot_java_random_user.data.converters.UserConverter;
-import com.xpeho.spring_boot_java_random_user.data.models.db.User;
+import com.xpeho.spring_boot_java_random_user.data.models.database.User;
 import com.xpeho.spring_boot_java_random_user.data.sources.database.UserRepository;
 import com.xpeho.spring_boot_java_random_user.domain.entities.UserEntity;
 import com.xpeho.spring_boot_java_random_user.domain.services.LocalUserService;

…_user/data/sources/api/DummyUserApi.java …data/sources/api/dummy/DummyUserApi.javasrc/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserApi.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/dummy/DummyUserApi.java src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserApi.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/dummy/DummyUserApi.java

@@ -1,4 +1,4 @@
-package com.xpeho.spring_boot_java_random_user.data.sources.api;
+package com.xpeho.spring_boot_java_random_user.data.sources.api.dummy;
 
 import com.xpeho.spring_boot_java_random_user.data.models.api.dummy.DummyUserResponse;
 import retrofit2.Call;

…data/sources/api/DummyUserApiConfig.java …ources/api/dummy/DummyUserApiConfig.javasrc/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserApiConfig.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/dummy/DummyUserApiConfig.java src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/DummyUserApiConfig.java renamed to src/main/java/com/xpeho/spring_boot_java_random_user/data/sources/api/dummy/DummyUserApiConfig.java

@@ -1,6 +1,6 @@
-package com.xpeho.spring_boot_java_random_user.data.sources.api;
+package com.xpeho.spring_boot_java_random_user.data.sources.api.dummy;
 
-import okhttp3.OkHttpClient;
+import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.core.env.Environment;
@@ -9,19 +9,16 @@
 
 @Configuration
 public class DummyUserApiConfig {
-    @Bean
+    @Bean(name = "dummyUserRetrofit")
     public Retrofit dummyUserRetrofit(Environment env) {
-        String baseUrl = env.getRequiredProperty("dummy.api.base-url");
-        OkHttpClient client = new OkHttpClient.Builder().build();
         return new Retrofit.Builder()
-                .baseUrl(baseUrl)
+                .baseUrl(env.getRequiredProperty("dummy.api.base-url"))
                 .addConverterFactory(GsonConverterFactory.create())
-                .client(client)
                 .build();
     }
 
     @Bean
-    public DummyUserApi dummyUserApi(Retrofit dummyUserRetrofit) {
+    public DummyUserApi dummyUserApi(@Qualifier("dummyUserRetrofit") Retrofit dummyUserRetrofit) {
         return dummyUserRetrofit.create(DummyUserApi.class);
     }
 }