diff --git a/src/main/java/br/com/db/petcontrol/controller/TagsController.java b/src/main/java/br/com/db/petcontrol/controller/TagsController.java new file mode 100644 index 0000000..5b82233 --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/controller/TagsController.java @@ -0,0 +1,30 @@ +package br.com.db.petcontrol.controller; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.media.Content; +import io.swagger.v3.oas.annotations.media.Schema; +import io.swagger.v3.oas.annotations.responses.ApiResponse; +import io.swagger.v3.oas.annotations.tags.Tag; +import java.util.List; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; + +@Tag(name = "Tags", description = "Operações para listagem de tags disponíveis") +@RequestMapping("/tags") +public interface TagsController { + + @Operation( + summary = "Listar todas as tags", + description = "Retorna todas as tags cadastradas no sistema em ordem alfabética") + @ApiResponse( + responseCode = "200", + description = "Lista de tags retornada com sucesso", + content = + @Content( + mediaType = "application/json", + schema = @Schema(implementation = TagsResponseDTO.class))) + @GetMapping + ResponseEntity> getAllTags(); +} diff --git a/src/main/java/br/com/db/petcontrol/controller/impl/TagsControllerImpl.java b/src/main/java/br/com/db/petcontrol/controller/impl/TagsControllerImpl.java new file mode 100644 index 0000000..8a78911 --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/controller/impl/TagsControllerImpl.java @@ -0,0 +1,24 @@ +package br.com.db.petcontrol.controller.impl; + +import br.com.db.petcontrol.controller.TagsController; +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.service.TagsService; +import java.util.List; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.RestController; + +@RestController +public class TagsControllerImpl implements TagsController { + + private final TagsService service; + + public TagsControllerImpl(TagsService service) { + this.service = service; + } + + @Override + public ResponseEntity> getAllTags() { + List tags = service.getAllTags(); + return ResponseEntity.ok(tags); + } +} diff --git a/src/main/java/br/com/db/petcontrol/dto/response/TagsResponseDTO.java b/src/main/java/br/com/db/petcontrol/dto/response/TagsResponseDTO.java new file mode 100644 index 0000000..efbb49a --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/dto/response/TagsResponseDTO.java @@ -0,0 +1,14 @@ +package br.com.db.petcontrol.dto.response; + +import io.swagger.v3.oas.annotations.media.Schema; +import java.util.UUID; +import lombok.Builder; + +@Builder +@Schema(description = "Resposta com informações da tag") +public record TagsResponseDTO( + @Schema( + description = "Identificador único da tag", + example = "d6acb364-305e-4883-964f-0e7aee360684") + UUID id, + @Schema(description = "Nome da tag", example = "Vacinado") String name) {} diff --git a/src/main/java/br/com/db/petcontrol/mapper/TagsMapper.java b/src/main/java/br/com/db/petcontrol/mapper/TagsMapper.java new file mode 100644 index 0000000..20d9834 --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/mapper/TagsMapper.java @@ -0,0 +1,11 @@ +package br.com.db.petcontrol.mapper; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.model.Tags; +import org.mapstruct.Mapper; + +@Mapper(componentModel = "spring") +public interface TagsMapper { + + TagsResponseDTO toDTO(Tags tags); +} diff --git a/src/main/java/br/com/db/petcontrol/model/Tags.java b/src/main/java/br/com/db/petcontrol/model/Tags.java new file mode 100644 index 0000000..abb4f03 --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/model/Tags.java @@ -0,0 +1,29 @@ +package br.com.db.petcontrol.model; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import java.util.UUID; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Entity +@Table(name = "tb_tags") +@Getter +@NoArgsConstructor +@AllArgsConstructor +@Builder +public class Tags { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false, unique = true) + private String name; +} diff --git a/src/main/java/br/com/db/petcontrol/repository/TagsRepository.java b/src/main/java/br/com/db/petcontrol/repository/TagsRepository.java new file mode 100644 index 0000000..90f36bf --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/repository/TagsRepository.java @@ -0,0 +1,13 @@ +package br.com.db.petcontrol.repository; + +import br.com.db.petcontrol.model.Tags; +import java.util.List; +import java.util.UUID; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface TagsRepository extends JpaRepository { + + List findAllByOrderByNameAsc(); +} diff --git a/src/main/java/br/com/db/petcontrol/service/TagsService.java b/src/main/java/br/com/db/petcontrol/service/TagsService.java new file mode 100644 index 0000000..b8e0faf --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/service/TagsService.java @@ -0,0 +1,9 @@ +package br.com.db.petcontrol.service; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import java.util.List; + +public interface TagsService { + + List getAllTags(); +} diff --git a/src/main/java/br/com/db/petcontrol/service/impl/TagsServiceImpl.java b/src/main/java/br/com/db/petcontrol/service/impl/TagsServiceImpl.java new file mode 100644 index 0000000..682a536 --- /dev/null +++ b/src/main/java/br/com/db/petcontrol/service/impl/TagsServiceImpl.java @@ -0,0 +1,25 @@ +package br.com.db.petcontrol.service.impl; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.mapper.TagsMapper; +import br.com.db.petcontrol.repository.TagsRepository; +import br.com.db.petcontrol.service.TagsService; +import java.util.List; +import org.springframework.stereotype.Service; + +@Service +public class TagsServiceImpl implements TagsService { + + private final TagsRepository repository; + private final TagsMapper mapper; + + public TagsServiceImpl(TagsRepository repository, TagsMapper mapper) { + this.repository = repository; + this.mapper = mapper; + } + + @Override + public List getAllTags() { + return repository.findAllByOrderByNameAsc().stream().map(mapper::toDTO).toList(); + } +} diff --git a/src/main/resources/db/migrations/V20260424162740__create_table_tags.sql b/src/main/resources/db/migrations/V20260424162740__create_table_tags.sql new file mode 100644 index 0000000..bf60f69 --- /dev/null +++ b/src/main/resources/db/migrations/V20260424162740__create_table_tags.sql @@ -0,0 +1,4 @@ +CREATE TABLE IF NOT EXISTS tb_tags ( + id UUID PRIMARY KEY DEFAULT uuid_generate_v4(), + name VARCHAR(100) NOT NULL UNIQUE +); \ No newline at end of file diff --git a/src/main/resources/db/migrations/V20260424162920__insert_default_tags.sql b/src/main/resources/db/migrations/V20260424162920__insert_default_tags.sql new file mode 100644 index 0000000..7a918c8 --- /dev/null +++ b/src/main/resources/db/migrations/V20260424162920__insert_default_tags.sql @@ -0,0 +1,11 @@ +INSERT INTO tb_tags (name) VALUES +('adaptado a apartamento'), +('amigável'), +('castrado'), +('independente'), +('necessita de cuidados especiais'), +('sociável com outros animais'), +('treinado'), +('vacinado'), +('vermifugado') +ON CONFLICT (name) DO NOTHING; \ No newline at end of file diff --git a/src/test/java/br/com/db/petcontrol/controller/TagsControllerTest.java b/src/test/java/br/com/db/petcontrol/controller/TagsControllerTest.java new file mode 100644 index 0000000..d0c77e1 --- /dev/null +++ b/src/test/java/br/com/db/petcontrol/controller/TagsControllerTest.java @@ -0,0 +1,76 @@ +package br.com.db.petcontrol.controller; + +import static org.hamcrest.Matchers.hasSize; +import static org.mockito.Mockito.when; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +import br.com.db.petcontrol.controller.impl.TagsControllerImpl; +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.mocks.TagsFixture; +import br.com.db.petcontrol.service.TagsService; +import java.util.List; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest; +import org.springframework.boot.test.mock.mockito.MockBean; +import org.springframework.http.MediaType; +import org.springframework.test.web.servlet.MockMvc; + +@WebMvcTest(TagsControllerImpl.class) +class TagsControllerTest { + + @Autowired private MockMvc mockMvc; + + @MockBean private TagsService service; + + private static final String TAGS_URL = "/tags"; + + @Nested + class GetAllTagsTests { + + @Test + void shouldListAllTagsSuccessfully() throws Exception { + TagsResponseDTO tags1 = TagsFixture.dtoBuilder().name("adaptado a apartamento").build(); + TagsResponseDTO tags2 = TagsFixture.dtoBuilder().name("amigável").build(); + TagsResponseDTO tags3 = TagsFixture.dtoBuilder().name("castrado").build(); + + when(service.getAllTags()).thenReturn(List.of(tags1, tags2, tags3)); + + mockMvc + .perform(get(TAGS_URL).contentType(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(content().contentType(MediaType.APPLICATION_JSON)) + .andExpect(jsonPath("$", hasSize(3))) + .andExpect(jsonPath("$[0].name").value("adaptado a apartamento")) + .andExpect(jsonPath("$[1].name").value("amigável")) + .andExpect(jsonPath("$[2].name").value("castrado")); + } + + @Test + void shouldReturnListWithOneTags() throws Exception { + TagsResponseDTO tags = TagsFixture.dtoBuilder().name("amigável").build(); + + when(service.getAllTags()).thenReturn(List.of(tags)); + + mockMvc + .perform(get(TAGS_URL).contentType(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$", hasSize(1))) + .andExpect(jsonPath("$[0].name").value("amigável")); + } + + @Test + void shouldReturnEmptyListWhenNoTagsExist() throws Exception { + when(service.getAllTags()).thenReturn(List.of()); + + mockMvc + .perform(get(TAGS_URL).contentType(MediaType.APPLICATION_JSON)) + .andExpect(status().isOk()) + .andExpect(jsonPath("$", hasSize(0))); + } + } +} diff --git a/src/test/java/br/com/db/petcontrol/integration/TagsIntegrationTest.java b/src/test/java/br/com/db/petcontrol/integration/TagsIntegrationTest.java new file mode 100644 index 0000000..7a20892 --- /dev/null +++ b/src/test/java/br/com/db/petcontrol/integration/TagsIntegrationTest.java @@ -0,0 +1,71 @@ +package br.com.db.petcontrol.integration; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.junit.jupiter.api.Assertions.assertEquals; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.model.Tags; +import br.com.db.petcontrol.repository.TagsRepository; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.boot.test.web.client.TestRestTemplate; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.test.context.ActiveProfiles; + +@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) +@ActiveProfiles("test") +class TagsIntegrationTest { + + @Autowired private TestRestTemplate restTemplate; + + @Autowired private TagsRepository repository; + + private static final String TAGS_URL = "/tags"; + + @AfterEach + void tearDown() { + repository.deleteAll(); + } + + @Test + void shouldReturnTagsOrderedByNameAsc() { + repository.save(new Tags(null, "adaptado a apartamento")); + repository.save(new Tags(null, "amigável")); + repository.save(new Tags(null, "castrado")); + + ResponseEntity response = + restTemplate.getForEntity(TAGS_URL, TagsResponseDTO[].class); + + assertEquals(HttpStatus.OK, response.getStatusCode()); + assertThat(response.getBody()).hasSize(3); + assertThat(response.getBody()[0].name()).isEqualTo("adaptado a apartamento"); + assertThat(response.getBody()[1].name()).isEqualTo("amigável"); + assertThat(response.getBody()[2].name()).isEqualTo("castrado"); + } + + @Test + void shouldReturnEmptyListWhenNoTagsExist() { + ResponseEntity response = + restTemplate.getForEntity(TAGS_URL, TagsResponseDTO[].class); + + assertEquals(HttpStatus.OK, response.getStatusCode()); + assertThat(response.getBody()).isEmpty(); + } + + @Test + void shouldReturnMultipleTagsWithCorrectIds() { + Tags tags1 = repository.save(new Tags(null, "adaptado a apartamento")); + Tags tags2 = repository.save(new Tags(null, "amigável")); + + ResponseEntity response = + restTemplate.getForEntity(TAGS_URL, TagsResponseDTO[].class); + + assertEquals(HttpStatus.OK, response.getStatusCode()); + assertThat(response.getBody()).hasSize(2); + assertThat(response.getBody()[0].id()).isEqualTo(tags1.getId()); + assertThat(response.getBody()[1].id()).isEqualTo(tags2.getId()); + } +} diff --git a/src/test/java/br/com/db/petcontrol/mocks/TagsFixture.java b/src/test/java/br/com/db/petcontrol/mocks/TagsFixture.java new file mode 100644 index 0000000..56c5ecf --- /dev/null +++ b/src/test/java/br/com/db/petcontrol/mocks/TagsFixture.java @@ -0,0 +1,20 @@ +package br.com.db.petcontrol.mocks; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.model.Tags; +import java.util.UUID; + +public final class TagsFixture { + + private static final String DEFAULT_NAME = "amigável"; + + private TagsFixture() {} + + public static Tags.TagsBuilder builder() { + return Tags.builder().id(UUID.randomUUID()).name(DEFAULT_NAME); + } + + public static TagsResponseDTO.TagsResponseDTOBuilder dtoBuilder() { + return TagsResponseDTO.builder().id(UUID.randomUUID()).name(DEFAULT_NAME); + } +} diff --git a/src/test/java/br/com/db/petcontrol/service/TagsServiceTest.java b/src/test/java/br/com/db/petcontrol/service/TagsServiceTest.java new file mode 100644 index 0000000..ec83b61 --- /dev/null +++ b/src/test/java/br/com/db/petcontrol/service/TagsServiceTest.java @@ -0,0 +1,115 @@ +package br.com.db.petcontrol.service; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +import br.com.db.petcontrol.dto.response.TagsResponseDTO; +import br.com.db.petcontrol.mapper.TagsMapper; +import br.com.db.petcontrol.mocks.TagsFixture; +import br.com.db.petcontrol.model.Tags; +import br.com.db.petcontrol.repository.TagsRepository; +import br.com.db.petcontrol.service.impl.TagsServiceImpl; +import java.util.List; +import java.util.UUID; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Nested; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mapstruct.factory.Mappers; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +@ExtendWith(MockitoExtension.class) +class TagsServiceTest { + + @Mock private TagsRepository repository; + + private TagsServiceImpl service; + + private TagsMapper mapper; + + @BeforeEach + void setUp() { + mapper = Mappers.getMapper(TagsMapper.class); + service = new TagsServiceImpl(repository, mapper); + } + + @Nested + class GetAllTagsTests { + + @Test + void shouldReturnAllTagsOrdered() { + List tags = + List.of( + TagsFixture.builder().name("adaptado a apartamento").build(), + TagsFixture.builder().name("amigável").build(), + TagsFixture.builder().name("castrado").build(), + TagsFixture.builder().name("independente").build(), + TagsFixture.builder().name("necessita de cuidados especiais").build(), + TagsFixture.builder().name("sociável com outros animais").build(), + TagsFixture.builder().name("treinado").build(), + TagsFixture.builder().name("vacinado").build(), + TagsFixture.builder().name("vermifugado").build()); + + when(repository.findAllByOrderByNameAsc()).thenReturn(tags); + + List result = service.getAllTags(); + + assertThat(result) + .hasSize(9) + .extracting(TagsResponseDTO::name) + .containsExactly( + "adaptado a apartamento", + "amigável", + "castrado", + "independente", + "necessita de cuidados especiais", + "sociável com outros animais", + "treinado", + "vacinado", + "vermifugado"); + + verify(repository).findAllByOrderByNameAsc(); + } + + @Test + void shouldReturnTagsWithCorrectIds() { + UUID id1 = UUID.randomUUID(); + UUID id2 = UUID.randomUUID(); + + when(repository.findAllByOrderByNameAsc()) + .thenReturn( + List.of( + TagsFixture.builder().id(id1).name("adaptado a apartamento").build(), + TagsFixture.builder().id(id2).name("amigável").build())); + + List result = service.getAllTags(); + + assertThat(result).hasSize(2).extracting(TagsResponseDTO::id).containsExactly(id1, id2); + } + + @Test + void shouldReturnEmptyList() { + when(repository.findAllByOrderByNameAsc()).thenReturn(List.of()); + + assertThat(service.getAllTags()).isEmpty(); + + verify(repository).findAllByOrderByNameAsc(); + } + + @Test + void shouldMapEntityFieldsCorrectly() { + UUID id = UUID.randomUUID(); + String nome = "amigável"; + + when(repository.findAllByOrderByNameAsc()) + .thenReturn(List.of(TagsFixture.builder().id(id).name(nome).build())); + + TagsResponseDTO dto = service.getAllTags().getFirst(); + + assertThat(dto.id()).isEqualTo(id); + assertThat(dto.name()).isEqualTo(nome); + } + } +}