feat: 필터 API를 구현한다

backend/src/docs/asciidoc/Filter.adoc

@@ -0,0 +1,44 @@
+= Filter API 문서
+:doctype: book
+:icons: font
+:source-highlighter: highlightjs
+:toc: left
+:toclevels: 3
+
+== 등록된 필터를 모두 조회한다. (/filters)
+
+=== Request
+
+include::{snippets}/filter-controller-test/find_all_filters/request-headers.adoc[]
+include::{snippets}/filter-controller-test/find_all_filters/http-request.adoc[]
+
+=== Response
+
+include::{snippets}/filter-controller-test/find_all_filters/response-fields.adoc[]
+include::{snippets}/filter-controller-test/find_all_filters/http-response.adoc[]
+
+== 필터를 등록한다. (/filters)
+
+=== Request
+
+include::{snippets}/filter-controller-test/add_filters/request-headers.adoc[]
+include::{snippets}/filter-controller-test/add_filters/request-fields.adoc[]
+include::{snippets}/filter-controller-test/add_filters/http-request.adoc[]
+
+=== Response
+
+include::{snippets}/filter-controller-test/add_filters/response-fields.adoc[]
+include::{snippets}/filter-controller-test/add_filters/http-response.adoc[]
+
+
+== 필터를 제거한다. (/filters/{filterName})
+
+=== Request
+
+include::{snippets}/filter-controller-test/delete_filter/request-headers.adoc[]
+include::{snippets}/filter-controller-test/delete_filter/path-parameters.adoc[]
+include::{snippets}/filter-controller-test/delete_filter/http-request.adoc[]
+
+=== Response
+
+include::{snippets}/filter-controller-test/delete_filter/http-response.adoc[]

backend/src/docs/asciidoc/index.adoc

@@ -8,3 +8,4 @@ endif::[]
 :sectlinks:
 
 include::station.adoc[]
+include::Filter.adoc[]

backend/src/main/java/com/carffeine/carffeine/filter/controller/FilterController.java

@@ -0,0 +1,43 @@
+package com.carffeine.carffeine.filter.controller;
+
+import com.carffeine.carffeine.auth.controller.AuthMember;
+import com.carffeine.carffeine.filter.dto.FiltersRequest;
+import com.carffeine.carffeine.filter.dto.FiltersResponse;
+import com.carffeine.carffeine.filter.service.FilterService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RequiredArgsConstructor
+@RequestMapping("/filters")
+@RestController
+public class FilterController {
+
+    private final FilterService filterService;
+
+    @GetMapping
+    public ResponseEntity<FiltersResponse> findAllFilters(@AuthMember Long memberId) {
+        return ResponseEntity.ok(FiltersResponse.from(filterService.findAllFilters(memberId)));
+    }
+
+    @PostMapping
+    public ResponseEntity<FiltersResponse> addFilters(@AuthMember Long memberId,
+                                                      @RequestBody FiltersRequest filtersRequest) {
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(filterService.addFilters(memberId, filtersRequest));
+    }
+
+    @DeleteMapping("/{filterName}")
+    public ResponseEntity<Void> deleteFilter(@AuthMember Long memberId,
+                                             @PathVariable String filterName) {
+        filterService.deleteFilter(memberId, filterName);
+        return ResponseEntity.noContent().build();
+    }
+}

backend/src/main/java/com/carffeine/carffeine/filter/domain/Filter.java

@@ -0,0 +1,59 @@
+package com.carffeine.carffeine.filter.domain;
+
+import com.carffeine.carffeine.common.domain.BaseEntity;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.EnumType;
+import javax.persistence.Enumerated;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Table;
+
+@Getter
+@Builder
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@EqualsAndHashCode(of = {"id"}, callSuper = false)
+@Table(name = "filter")
+@Entity
+public class Filter extends BaseEntity {
+
+    private static final String DECIMAL_SIGN = ".00";
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(nullable = false, unique = true)
+    private String name;
+
+    @Enumerated(EnumType.STRING)
+    private FilterType filterType;
+
+    public static Filter of(String name, String filterType) {
+        FilterType type = FilterType.from(filterType);
+
+        if (type.isCapacities()) {
+            String capacity = makeCapacity(name);
+            return new Filter(null, capacity, type);
+        }
+
+        return new Filter(null, name, type);
+    }
+
+    private static String makeCapacity(String capacity) {
+        if (capacity.endsWith(DECIMAL_SIGN)) {
+            return capacity;
+        }
+
+        return capacity + DECIMAL_SIGN;
+    }
+}

backend/src/main/java/com/carffeine/carffeine/filter/domain/FilterRepository.java

@@ -0,0 +1,17 @@
+package com.carffeine.carffeine.filter.domain;
+
+import org.springframework.data.repository.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+public interface FilterRepository extends Repository<Filter, Long> {
+
+    List<Filter> findAll();
+
+    <S extends Filter> List<S> saveAll(Iterable<S> filters);
+
+    Optional<Filter> findByName(String name);
+
+    void deleteByName(String name);
+}

backend/src/main/java/com/carffeine/carffeine/filter/domain/FilterType.java

@@ -0,0 +1,42 @@
+package com.carffeine.carffeine.filter.domain;
+
+import com.carffeine.carffeine.filter.exception.FilterException;
+import com.carffeine.carffeine.filter.exception.FilterExceptionType;
+
+import java.util.Arrays;
+
+public enum FilterType {
+
+    COMPANIES("companies"),
+    CAPACITIES("capacities"),
+    CONNECTOR_TYPES("connectorTypes");
+
+    private final String name;
+
+    FilterType(String name) {
+        this.name = name;
+    }
+
+    public static FilterType from(String name) {
+        return Arrays.stream(values())
+                .filter(it -> it.getName().equals(name))
+                .findAny()
+                .orElseThrow(() -> new FilterException(FilterExceptionType.FILTER_NOT_FOUND));
+    }
+
+    public boolean isCompanies() {
+        return this.name.equals(COMPANIES.name);
+    }
+
+    public boolean isConnectorTypes() {
+        return this.name.equals(CONNECTOR_TYPES.name);
+    }
+
+    public boolean isCapacities() {
+        return this.name.equals(CAPACITIES.name);
+    }
+
+    public String getName() {
+        return name;
+    }
+}

backend/src/main/java/com/carffeine/carffeine/filter/dto/FiltersRequest.java

@@ -0,0 +1,10 @@
+package com.carffeine.carffeine.filter.dto;
+
+import java.util.List;
+
+public record FiltersRequest(
+        List<String> companies,
+        List<String> capacities,
+        List<String> connectorTypes
+) {
+}

backend/src/main/java/com/carffeine/carffeine/filter/dto/FiltersResponse.java

@@ -0,0 +1,56 @@
+package com.carffeine.carffeine.filter.dto;
+
+import com.carffeine.carffeine.filter.domain.Filter;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+public record FiltersResponse(
+        List<String> companies,
+        List<String> capacities,
+        List<String> connectorTypes
+) {
+
+    public static FiltersResponse from(List<Filter> filters) {
+        List<String> companies = filters.stream()
+                .filter(it -> it.getFilterType().isCompanies())
+                .map(Filter::getName)
+                .toList();
+
+        List<String> capacities = filters.stream()
+                .filter(it -> it.getFilterType().isCapacities())
+                .map(Filter::getName)
+                .toList();
+
+        List<String> connectorTypes = filters.stream()
+                .filter(it -> it.getFilterType().isConnectorTypes())
+                .map(Filter::getName)
+                .toList();
+
+        return new FiltersResponse(
+                companies,
+                capacities,
+                connectorTypes
+        );
+    }
+
+    public static FiltersResponse from(List<Filter> companiesFilter, List<Filter> capacitiesFilter, List<Filter> connectorTypesFilter) {
+        List<String> companies = companiesFilter.stream()
+                .map(Filter::getName)
+                .collect(Collectors.toList());
+
+        List<String> capacities = capacitiesFilter.stream()
+                .map(Filter::getName)
+                .collect(Collectors.toList());
+
+        List<String> connectorTypes = connectorTypesFilter.stream()
+                .map(Filter::getName)
+                .collect(Collectors.toList());
+
+        return new FiltersResponse(
+                companies,
+                capacities,
+                connectorTypes
+        );
+    }
+}

backend/src/main/java/com/carffeine/carffeine/filter/exception/FilterException.java

@@ -0,0 +1,11 @@
+package com.carffeine.carffeine.filter.exception;
+
+import com.carffeine.carffeine.common.exception.BaseException;
+import com.carffeine.carffeine.common.exception.ExceptionType;
+
+public class FilterException extends BaseException {
+
+    public FilterException(ExceptionType exceptionType) {
+        super(exceptionType);
+    }
+}

backend/src/main/java/com/carffeine/carffeine/filter/exception/FilterExceptionType.java

@@ -0,0 +1,34 @@
+package com.carffeine.carffeine.filter.exception;
+
+import com.carffeine.carffeine.common.exception.ExceptionType;
+import com.carffeine.carffeine.common.exception.Status;
+
+public enum FilterExceptionType implements ExceptionType {
+
+    FILTER_NOT_FOUND(Status.NOT_FOUND, 1001, "해당 필터를 찾을 수 없습니다.");
+
+    private final Status status;
+    private final int exceptionCode;
+    private final String message;
+
+    FilterExceptionType(Status status, int exceptionCode, String message) {
+        this.status = status;
+        this.exceptionCode = exceptionCode;
+        this.message = message;
+    }
+
+    @Override
+    public Status status() {
+        return status;
+    }
+
+    @Override
+    public int exceptionCode() {
+        return exceptionCode;
+    }
+
+    @Override
+    public String message() {
+        return message;
+    }
+}