✨ feat: 태그 생성 기능 개발 (#89)

* 🚚 rename: Tag 도메인 분리

기존 Organization에서 다루던 Tag 엔티티
개발 편의를 위해 도메인 분리, 그에 따른 파일 이동

* ✨ feat: Tag 도메인 기본 클래스 생성

* 🚚 rename: Tag 도메인 생성에 따른 TagResponse 클래스 도메인 패키지 내로 이동

* ✨ feat: OrganizationTag 삭제에 따른 연관관계 수정

* ✨ feat: Tag 생성 기능 개발

* ✅ test: Tag 생성 기능 테스트 request 구현

Author: dbwp031

http/test.http

@@ -1,4 +1,4 @@
-@matsterToken = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiZW1haWwiOiJzcG9udXNAZ21haWwuY29tIiwiYXV0aCI6IlNUVURFTlQiLCJpYXQiOjE3MDU4MzQ2MTksImV4cCI6MTcwNjgzNDYxOX0.XO8ydia0RB1eVGXrA7nBeP5AND2Ui4ivK26DEldZLnE
+@masterToken = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwiZW1haWwiOiJzcG9udXNAZ21haWwuY29tIiwiYXV0aCI6IlNUVURFTlQiLCJpYXQiOjE3MDU4MzQ2MTksImV4cCI6MTcwNjgzNDYxOX0.XO8ydia0RB1eVGXrA7nBeP5AND2Ui4ivK26DEldZLnE
 
 ### 회원가입
 POST http://localhost:8080/api/v1/organizations/join
@@ -31,7 +31,7 @@ Content-Type: application/json
 
 ### 공고 생성
 POST http://localhost:8080/api/v1/announcements
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 Content-Type: application/json
 
 {
@@ -43,15 +43,15 @@ Content-Type: application/json
 
 ### 공고 상세 조회
 GET http://localhost:8080/api/v1/announcements/1
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 
 ### 공고 상태별 목록 조회
 GET http://localhost:8080/api/v1/announcements/status?status=POSTED
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 
 ### 공고 수정
 PATCH http://localhost:8080/api/v1/announcements/1
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 Content-Type: application/json
 
 {
@@ -63,7 +63,7 @@ Content-Type: application/json
 
 ### 공고 삭제 (생성한 단체만 삭제 가능)
 DELETE http://localhost:8080/api/v1/announcements/1
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 
 ### 보고서 작성
 POST http://localhost:8080/api/v1/reports
@@ -84,11 +84,11 @@ GET http://localhost:8080/api/v1/announcements?search=무신사
 
 ### 내 조직 조회
 GET http://localhost:8080/api/v1/organizations/me
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 
 ### 내 조직 수정
 PATCH http://localhost:8080/api/v1/organizations/me
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 Content-Type: application/json
 
 {
@@ -109,7 +109,7 @@ Content-Type: application/json
 
 ### 내 조직 수정 2
 PATCH http://localhost:8080/api/v1/organizations/me
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 Content-Type: application/json
 
 {
@@ -118,8 +118,18 @@ Content-Type: application/json
 
 ### 내 조직 삭제 [soft delete] (OrganizationStatus = INACTIVE)
 DELETE http://localhost:8080/api/v1/organizations/me
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
 
 ### 조직 조회
 GET http://localhost:8080/api/v1/organizations/1
-Authorization: Bearer {{matsterToken}}
+Authorization: Bearer {{masterToken}}
+
+### 태그 생성
+POST http://localhost:8080/api/v1/tags
+Authorization: Bearer {{masterToken}}
+Content-Type: application/json
+
+{
+  "name": "태그 name test2"
+}
+

src/main/java/com/sponus/sponusbe/domain/organization/dto/OrganizationDetailGetResponse.java

@@ -6,6 +6,7 @@
 import com.sponus.sponusbe.domain.organization.entity.enums.OrganizationStatus;
 import com.sponus.sponusbe.domain.organization.entity.enums.OrganizationType;
 import com.sponus.sponusbe.domain.organization.entity.enums.SuborganizationType;
+import com.sponus.sponusbe.domain.tag.dto.TagGetResponse;
 
 public record OrganizationDetailGetResponse(
 	Long organizationId,
@@ -29,7 +30,7 @@ public record OrganizationDetailGetResponse(
 	List<OrganizationLinkGetResponse> links
 ) {
 	public static OrganizationDetailGetResponse from(Organization organization) {
-		List<TagGetResponse> tagGetResponses = TagGetResponse.getTagResponses(organization);
+		List<TagGetResponse> tagGetResponses = TagGetResponse.getTagResponse(organization);
 		List<OrganizationLinkGetResponse> linkGetResponses = OrganizationLinkGetResponse.getOrganizationLinkResponses(
 			organization);
 		return new OrganizationDetailGetResponse(

src/main/java/com/sponus/sponusbe/domain/organization/dto/TagGetResponse.java

@@ -7,6 +7,7 @@
 import com.sponus.sponusbe.domain.organization.entity.enums.OrganizationStatus;
 import com.sponus.sponusbe.domain.organization.entity.enums.OrganizationType;
 import com.sponus.sponusbe.domain.organization.entity.enums.SuborganizationType;
+import com.sponus.sponusbe.domain.tag.entity.Tag;
 import com.sponus.sponusbe.global.common.BaseEntity;
 
 import jakarta.persistence.Column;
@@ -91,7 +92,7 @@ public class Organization extends BaseEntity {
 
 	@Builder.Default
 	@OneToMany(mappedBy = "organization", fetch = FetchType.EAGER)
-	private List<OrganizationTag> organizationTags = new ArrayList<>();
+	private List<Tag> tags = new ArrayList<>();
 
 	@Builder.Default
 	@OneToMany(mappedBy = "organization", fetch = FetchType.EAGER)

src/main/java/com/sponus/sponusbe/domain/organization/entity/Organization.java

@@ -0,0 +1,30 @@
+package com.sponus.sponusbe.domain.tag.controller;
+
+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;
+
+import com.sponus.sponusbe.auth.annotation.AuthOrganization;
+import com.sponus.sponusbe.domain.organization.entity.Organization;
+import com.sponus.sponusbe.domain.tag.dto.request.TagCreateRequest;
+import com.sponus.sponusbe.domain.tag.dto.resposne.TagCreateResponse;
+import com.sponus.sponusbe.domain.tag.service.TagService;
+import com.sponus.sponusbe.global.common.ApiResponse;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/tags")
+@RestController
+public class TagController {
+	private final TagService tagService;
+
+	@PostMapping
+	public ApiResponse<TagCreateResponse> createTag(@AuthOrganization Organization organization,
+		@RequestBody TagCreateRequest request) {
+		return ApiResponse.onSuccess(tagService.createTag(organization.getId(), request));
+	}
+}

src/main/java/com/sponus/sponusbe/domain/organization/entity/Tag.java

@@ -0,0 +1,23 @@
+package com.sponus.sponusbe.domain.tag.dto;
+
+import java.util.List;
+
+import com.sponus.sponusbe.domain.organization.entity.Organization;
+import com.sponus.sponusbe.domain.tag.entity.Tag;
+
+public record TagGetResponse(
+	Long id,
+	String name
+) {
+	public static TagGetResponse from(Tag tag) {
+		return new TagGetResponse(tag.getId(), tag.getName());
+	}
+
+	public static List<TagGetResponse> getTagResponse(Organization organization) {
+		return organization.getTags()
+			.stream()
+			.map(TagGetResponse::from)
+			.toList();
+	}
+
+}

src/main/java/com/sponus/sponusbe/domain/tag/controller/TagController.java

@@ -0,0 +1,15 @@
+package com.sponus.sponusbe.domain.tag.dto.request;
+
+import com.sponus.sponusbe.domain.organization.entity.Organization;
+import com.sponus.sponusbe.domain.tag.entity.Tag;
+
+public record TagCreateRequest(
+	String name
+) {
+	public Tag toEntity(Organization organization) {
+		return Tag.builder()
+			.name(name)
+			.organization(organization)
+			.build();
+	}
+}

src/main/java/com/sponus/sponusbe/domain/tag/dto/TagGetResponse.java

@@ -0,0 +1,7 @@
+package com.sponus.sponusbe.domain.tag.dto.resposne;
+
+public record TagCreateResponse(
+	Long tagId,
+	Long organizationId
+) {
+}

src/main/java/com/sponus/sponusbe/domain/tag/dto/request/TagCreateRequest.java

@@ -1,4 +1,6 @@
-package com.sponus.sponusbe.domain.organization.entity;
+package com.sponus.sponusbe.domain.tag.entity;
+
+import com.sponus.sponusbe.domain.organization.entity.Organization;
 
 import jakarta.persistence.Column;
 import jakarta.persistence.ConstraintMode;
@@ -19,22 +21,21 @@
 
 @Builder
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor
 @Getter
 @Entity
-@Table(name = "organization_tag")
-public class OrganizationTag {
+@Table(name = "tag")
+public class Tag {
 
 	@Id
 	@GeneratedValue(strategy = GenerationType.IDENTITY)
-	@Column(name = "id")
+	@Column(name = "tag_id")
 	private Long id;
 
-	@ManyToOne(fetch = FetchType.LAZY, optional = false)
+	@ManyToOne(fetch = FetchType.LAZY)
 	@JoinColumn(name = "organization_id", foreignKey = @ForeignKey(ConstraintMode.NO_CONSTRAINT))
 	private Organization organization;
 
-	@ManyToOne(fetch = FetchType.LAZY, optional = false)
-	@JoinColumn(name = "tag_id", foreignKey = @ForeignKey(ConstraintMode.NO_CONSTRAINT))
-	private Tag tag;
+	@Column(name = "tag_name", nullable = false)
+	private String name;
 }

src/main/java/com/sponus/sponusbe/domain/tag/dto/resposne/TagCreateResponse.java

@@ -0,0 +1,27 @@
+package com.sponus.sponusbe.domain.tag.exception;
+
+import org.springframework.http.HttpStatus;
+
+import com.sponus.sponusbe.global.common.ApiResponse;
+import com.sponus.sponusbe.global.common.BaseErrorCode;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum TagErrorCode implements BaseErrorCode {
+	TAG_ERROR(HttpStatus.BAD_REQUEST, "ORG4000", "태그 관련 에러"),
+	INVALID_FORMAT(HttpStatus.BAD_REQUEST, "ORG4001", "잘못된 형식입니다."),
+	TAG_ALREADY_EXIST(HttpStatus.BAD_REQUEST, "ORG4002", "중복된 태그입니다."),
+	TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "ORG4040", "존재하지 않는 태그입니다.");
+
+	private final HttpStatus httpStatus;
+	private final String code;
+	private final String message;
+
+	@Override
+	public ApiResponse<Void> getErrorResponse() {
+		return ApiResponse.onFailure(code, message);
+	}
+}

src/main/java/com/sponus/sponusbe/domain/organization/entity/OrganizationTag.java src/main/java/com/sponus/sponusbe/domain/tag/entity/Tag.java

@@ -0,0 +1,10 @@
+package com.sponus.sponusbe.domain.tag.exception;
+
+import com.sponus.sponusbe.global.common.BaseErrorCode;
+import com.sponus.sponusbe.global.common.exception.CustomException;
+
+public class TagException extends CustomException {
+	public TagException(BaseErrorCode errorCode) {
+		super(errorCode);
+	}
+}

src/main/java/com/sponus/sponusbe/domain/tag/exception/TagErrorCode.java

@@ -0,0 +1,8 @@
+package com.sponus.sponusbe.domain.tag.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.sponus.sponusbe.domain.tag.entity.Tag;
+
+public interface TagRepository extends JpaRepository<Tag, Long> {
+}

src/main/java/com/sponus/sponusbe/domain/tag/exception/TagException.java

@@ -0,0 +1,12 @@
+package com.sponus.sponusbe.domain.tag.service;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import lombok.RequiredArgsConstructor;
+
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+@Service
+public class TagQueryService {
+}

src/main/java/com/sponus/sponusbe/domain/tag/repository/TagRepository.java

@@ -0,0 +1,36 @@
+package com.sponus.sponusbe.domain.tag.service;
+
+import static com.sponus.sponusbe.domain.organization.exception.OrganizationErrorCode.*;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.sponus.sponusbe.domain.organization.entity.Organization;
+import com.sponus.sponusbe.domain.organization.exception.OrganizationException;
+import com.sponus.sponusbe.domain.organization.repository.OrganizationRepository;
+import com.sponus.sponusbe.domain.tag.dto.request.TagCreateRequest;
+import com.sponus.sponusbe.domain.tag.dto.resposne.TagCreateResponse;
+import com.sponus.sponusbe.domain.tag.entity.Tag;
+import com.sponus.sponusbe.domain.tag.repository.TagRepository;
+
+import lombok.RequiredArgsConstructor;
+
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+@Service
+public class TagService {
+	private final OrganizationRepository organizationRepository;
+	private final TagRepository tagRepository;
+
+	@Transactional
+	public TagCreateResponse createTag(Long organizationId, TagCreateRequest request) {
+		Organization organization = organizationRepository.findById(organizationId)
+			.orElseThrow(() -> new OrganizationException(ORGANIZATION_NOT_FOUND));
+
+		Tag tag = request.toEntity(organization);
+		organization.getTags().add(tag);
+		tag = tagRepository.save(tag);
+
+		return new TagCreateResponse(tag.getId(), organization.getId());
+	}
+}