[FEAT/#12] teams / 팀 생성 · 조회 · 수정 · 삭제 로직 구현

src/main/kotlin/com/beat_it/global/config/SecurityConfig.kt

@@ -43,6 +43,7 @@ class SecurityConfig(
             .authorizeHttpRequests { auth ->
                 auth
                     .requestMatchers("/auth/**").permitAll()
+                    .requestMatchers("/teams/**").permitAll()
                     .requestMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll()
                     .anyRequest().authenticated()
             }

src/main/kotlin/com/beat_it/global/error/ErrorCode.kt

@@ -36,6 +36,16 @@ enum class ErrorCode(
     CALENDAR_START_TIME_REQUIRED(HttpStatus.BAD_REQUEST, "CALENDAR-008", "일정 시작 시각은 필수입니다."),
     CALENDAR_END_TIME_REQUIRED(HttpStatus.BAD_REQUEST, "CALENDAR-009", "일정 종료 시각은 필수입니다."),
 
+    // --- 팀 관련 에러 (TEAM) ---
+    TEAM_NO_CONTENT_TO_UPDATE(HttpStatus.BAD_REQUEST, "TEAM-001", "팀에 대해 변경할 내용이 업습니다."),
+    TEAM_NO_PERMISSION(HttpStatus.FORBIDDEN, "TEAM-002", "팀 조회 권한이 없습니다."),
+    TEAM_NOT_FOUND(HttpStatus.NOT_FOUND, "TEAM-003", "팀을 찾을 수 없습니다."),
+    TEAM_NAME_REQUIRED(HttpStatus.BAD_REQUEST, "TEAM-004", "팀 이름은 필수입니다."),
+    TEAM_NAME_TOO_LONG(HttpStatus.BAD_REQUEST, "TEAM-005", "팀 이름은 100자 이하여야 합니다."),
+    TEAM_DESCRIPTION_TOO_LONG(HttpStatus.BAD_REQUEST, "TEAM-006", "팀 설명은 500자 이하여야 합니다."),
+    TEAM_NO_UPDATE_PERMISSION(HttpStatus.FORBIDDEN, "TEAM-007","팀 수정 권한이 없습니다."),
+
+
     // --- 장소 관련 에러 ---
     LOCATION_NOT_FOUND(HttpStatus.NOT_FOUND, "LOCATION-001", "장소를 찾을 수 없습니다."),
 

src/main/kotlin/com/beat_it/team/controller/TeamController.kt

@@ -0,0 +1,78 @@
+package com.beat_it.team.controller
+
+import com.beat_it.team.dto.TeamCreateRequest
+import com.beat_it.team.dto.TeamCreateResponse
+import com.beat_it.team.dto.TeamDetailResponse
+import com.beat_it.team.dto.TeamDetailUpdateRequest
+import com.beat_it.team.dto.TeamDetailUpdateResponse
+import com.beat_it.team.service.TeamService
+import com.beat_it.global.response.BasicResponse
+import org.springframework.http.HttpStatus
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.*
+import java.util.UUID
+import io.swagger.v3.oas.annotations.Parameter
+
+@RestController
+@RequestMapping("/teams")
+class TeamController(
+    private val teamService: TeamService
+) {
+
+    @PostMapping
+    fun createTeam(
+        @Parameter(hidden = true)
+        @RequestHeader("X-User-Public-Id") userPublicId: UUID,
+
+        @RequestBody request: TeamCreateRequest
+    ): ResponseEntity<BasicResponse<TeamCreateResponse>> {
+
+        val responseData = teamService.createTeam(userPublicId, request)
+
+        return ResponseEntity
+            .status(HttpStatus.CREATED)
+            .body(BasicResponse.success(responseData, HttpStatus.CREATED, "팀 생성에 성공했습니다."))
+    }
+
+    @PatchMapping
+    fun updateTeamDetail(
+        @Parameter(hidden = true)
+        @RequestHeader("X-User-Public-Id") userPublicId: UUID,
+
+        @Parameter(hidden = true)
+        @RequestHeader("X-Team-Public-Id") teamPublicId: UUID,
+
+        @RequestBody request: TeamDetailUpdateRequest,
+    ): ResponseEntity<BasicResponse<TeamDetailUpdateResponse>> {
+        val responseData = teamService.updateTeamDetail(teamPublicId, userPublicId, request)
+        return ResponseEntity.ok(BasicResponse.success(responseData, HttpStatus.OK, "팀 상세 내용이 수정되었습니다."))
+    }
+
+    @DeleteMapping
+    fun deleteTeam(
+        @Parameter(hidden = true)
+        @RequestHeader("X-User-Public-Id") userPublicId: UUID,
+
+        @Parameter(hidden = true)
+        @RequestHeader("X-Team-Public-Id") teamPublicId: UUID,
+
+    ): ResponseEntity<BasicResponse<Nothing>> {
+        teamService.deleteTeam(teamPublicId, userPublicId)
+        return ResponseEntity.ok(
+            BasicResponse.success(HttpStatus.OK,"팀이 성공적으로 삭제되었습니다.")
+        )
+    }
+
+    @GetMapping
+    fun getTeamDetail(
+        @Parameter(hidden = true)
+        @RequestHeader("X-Team-Public-Id") teamPublicId: UUID,
+
+    ): ResponseEntity<BasicResponse<TeamDetailResponse>> {
+        val responseData = teamService.getTeamDetail(teamPublicId)
+        return ResponseEntity.ok(
+            BasicResponse.success(responseData, HttpStatus.OK,"팀 상세 내용 조회에 성공했습니다.")
+        )
+    }
+}
+

src/main/kotlin/com/beat_it/team/dto/TeamCreateRequest.kt

@@ -0,0 +1,15 @@
+package com.beat_it.team.dto
+
+import com.beat_it.team.entity.enum.TeamType
+import com.fasterxml.jackson.annotation.JsonProperty
+import io.swagger.v3.oas.annotations.media.Schema
+import java.time.LocalDate
+import java.time.OffsetDateTime
+
+data class TeamCreateRequest(
+    val teamName: String,
+    val description: String?,
+    val teamType: TeamType,
+    val establishedOn: LocalDate?,
+    val profileImageUrl: String?,
+)

src/main/kotlin/com/beat_it/team/dto/TeamCreateResponse.kt

@@ -0,0 +1,15 @@
+package com.beat_it.team.dto
+
+import com.beat_it.team.entity.enum.TeamType
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.time.OffsetDateTime
+
+data class TeamCreateResponse(
+    val teamId: Long,
+    val teamName: String,
+    val description: String?,
+    val inviteCode: String,
+    val teamType: TeamType,
+    val teamRole: String,
+    val createdAt: OffsetDateTime,
+)

src/main/kotlin/com/beat_it/team/dto/TeamDetailResponse.kt

@@ -0,0 +1,33 @@
+package com.beat_it.team.dto
+
+import com.beat_it.team.entity.enum.PlatformCode
+import java.time.LocalDate
+import java.time.OffsetDateTime
+
+data class TeamDetailResponse(
+    val teamId: Long? = null,
+    val profileImageUrl: String?,
+    val teamName: String,
+    val description: String?,
+    val establishedOn: LocalDate?,
+    val inviteCode: String,
+    val memberCount: Int,
+    val createdAt: OffsetDateTime,
+    val updatedAt: OffsetDateTime,
+    val links: List<LinksResponse>,
+    val parts: List<PartsResponse>,
+    val archiveCount: Int,
+    val cloudItemCount: Int,
+)
+
+data class LinksResponse(
+    val teamLinkId: Long,
+    val platformCode: PlatformCode,
+    val linkUrl: String,
+)
+
+data class PartsResponse(
+    val teamPartId: Long,
+    val partName: String,
+    val displayOrder: Int,
+)

src/main/kotlin/com/beat_it/team/dto/TeamDetailUpdateRequest.kt

@@ -0,0 +1,19 @@
+package com.beat_it.team.dto
+
+import com.beat_it.team.entity.enum.PlatformCode
+import com.beat_it.team.entity.enum.TeamType
+import java.time.LocalDate
+
+data class TeamDetailUpdateRequest(
+    val teamName: String? = null,
+    val description: String? = null,
+    val teamType: TeamType? = null,
+    val establishedOn: LocalDate? = null,
+    val profileImageUrl: String? = null,
+    val links: List<TeamLinksRequest>? = null,
+)
+
+data class TeamLinksRequest(
+    val platformCode: PlatformCode,
+    val linkUrl: String,
+)

src/main/kotlin/com/beat_it/team/dto/TeamDetailUpdateResponse.kt

@@ -0,0 +1,13 @@
+package com.beat_it.team.dto
+
+import java.time.LocalDate
+import java.time.OffsetDateTime
+
+data class TeamDetailUpdateResponse(
+    val teamId: Long,
+    val teamName: String,
+    val description: String?,
+    val establishedOn: LocalDate?,
+    val updatedAt: OffsetDateTime,
+    val links: List<LinksResponse>? = null,
+)

src/main/kotlin/com/beat_it/team/entity/TeamLinks.kt

@@ -0,0 +1,41 @@
+package com.beat_it.team.entity
+
+import com.beat_it.global.entity.BaseUpdatedTimeEntity
+import com.beat_it.team.entity.enum.PlatformCode
+import com.beat_it.team.entity.enum.TeamRole
+import io.swagger.v3.oas.annotations.links.Link
+import jakarta.persistence.*
+import java.time.OffsetDateTime
+
+@Entity
+@Table(name = "team_links")
+class TeamLinks(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name="team_link_id", nullable = false)
+    val teamLinkId: Long? = null,
+
+    //TODO: 팀 ID 연결하기
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "team_id", nullable = false)
+    val team: Teams,
+
+    @Enumerated(EnumType.STRING)
+    @Column(name="platform_code",nullable = false)
+    var platformCode: PlatformCode = PlatformCode.CUSTOM,
+
+    @Column(name="link_url",nullable = false)
+    var linkUrl: String = "",
+
+//    @Column(name="update_at",nullable = false)
+//    var updateAt: OffsetDateTime = OffsetDateTime.now(),
+//
+//    @Column(name="create_at",nullable = false)
+//    val createdAt: OffsetDateTime = OffsetDateTime.now(),
+
+) : BaseUpdatedTimeEntity() {
+    fun updateLink(platformCode: PlatformCode, linkUrl: String) {
+        this.platformCode = platformCode
+        this.linkUrl = linkUrl
+    }
+}

src/main/kotlin/com/beat_it/team/entity/TeamMemberships.kt

@@ -0,0 +1,38 @@
+package com.beat_it.team.entity
+
+import com.beat_it.global.entity.BaseUpdatedTimeEntity
+import com.beat_it.team.entity.enum.TeamRole
+import jakarta.persistence.*
+import java.time.OffsetDateTime
+
+@Entity
+@Table(name = "team_membership")
+class TeamMemberships(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "team_membership_id")
+    val teamMembershipId: Long? = null,
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "team_id", nullable = false)
+    val team: Teams,
+
+    @Column(name = "user_id", nullable = false)
+    val userId: Long,
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "team_role", nullable = false)
+    var teamRole: TeamRole = TeamRole.MEMBER,
+
+    @Column(name = "left_at", nullable = true)
+    var leftAt: OffsetDateTime? = null,
+) : BaseUpdatedTimeEntity() {
+
+    fun updateTeamRole(teamRole: TeamRole) {
+        this.teamRole = teamRole
+    }
+
+    fun leaveTeam() {
+        this.leftAt = OffsetDateTime.now()
+    }
+}

src/main/kotlin/com/beat_it/team/entity/TeamParts.kt

@@ -0,0 +1,50 @@
+package com.beat_it.team.entity
+
+import com.beat_it.global.entity.BaseUpdatedTimeEntity
+import com.beat_it.team.entity.enum.TeamRole
+import jakarta.persistence.*
+import java.time.OffsetDateTime
+
+@Entity
+@Table(name = "team_parts")
+class TeamParts(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name="team_part_id", nullable = false)
+    val teamPartId: Long? = null,
+
+    //TODO: 팀 ID 연결하기
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "team_id", nullable = false)
+    val team: Teams,
+
+    @Column(name="part_name", nullable = false)
+    var partName: String = "",
+
+    @Column(name="display_order", nullable = false)
+    var displayOrder: Int = 0,
+
+    @Column(name="is_active", nullable = false)
+    var isActive: Boolean = true,
+
+//    @Column(name="update_at", nullable = false)
+//    var updateAt: OffsetDateTime = OffsetDateTime.now(),
+//
+//    @Column(name="create_at", nullable = false)
+//    val createdAt: OffsetDateTime = OffsetDateTime.now(),
+
+    ) : BaseUpdatedTimeEntity() {
+    // TODO: 파트를 추가하는 함수를 넣어야 함.
+    fun updateTeamPart(
+        partName: String,
+        displayOrder: Int,
+    ) {
+        this.partName = partName
+        this.displayOrder = displayOrder
+    }
+
+    fun deactivateTeamPart() {
+        this.isActive = false
+    }
+
+}

src/main/kotlin/com/beat_it/team/entity/TeamSettings.kt

@@ -0,0 +1,27 @@
+package com.beat_it.team.entity
+
+import jakarta.persistence.*
+import java.time.OffsetDateTime
+
+@Entity
+@Table(name = "team_settings")
+class TeamSettings(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name="team_settings_id")
+    val teamSettingId: Long? = null,
+
+    //TODO: 팀 ID 연결하기
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "team_id", nullable = false)
+    val team: Teams,
+
+    @Column(name="max_storage", nullable = false)
+    var maxStorage: Int = 10,
+
+    @Column(name="used_storage", nullable = false)
+    var usedStorage: Int = 0,
+
+    @Column(name="update_at", nullable = false)
+    var updateAt: OffsetDateTime = OffsetDateTime.now(),
+)