Feat: Crew 생성, 정보 수정, 가입 관련 API

src/main/java/run/backend/domain/crew/controller/CrewController.java

@@ -0,0 +1,123 @@
+package run.backend.domain.crew.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+import run.backend.domain.crew.dto.common.CrewInviteCodeDto;
+import run.backend.domain.crew.dto.request.CrewInfoRequest;
+import run.backend.domain.crew.dto.response.*;
+import run.backend.domain.crew.entity.Crew;
+import run.backend.domain.crew.service.CrewEventService;
+import run.backend.domain.crew.service.CrewService;
+import run.backend.domain.member.entity.Member;
+import run.backend.global.annotation.member.Login;
+import run.backend.global.annotation.member.MemberCrew;
+import run.backend.global.common.response.CommonResponse;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/v1/crews")
+@Tag(name = "Crews", description = "Crew 관련 API")
+public class CrewController {
+
+    private final CrewService crewService;
+    private final CrewEventService crewEventService;
+
+    @PostMapping
+    @Operation(summary = "크루 생성", description = "크루 생성하는 API 입니다.")
+    public CommonResponse<CrewInviteCodeDto> createCrew(
+            @Login Member member,
+            @RequestParam String imageStatus,
+            @RequestPart(value = "data")CrewInfoRequest data,
+            @RequestPart(value = "image", required = false) MultipartFile image
+    ) {
+
+        CrewInviteCodeDto response = crewService.createCrew(member, imageStatus, image, data);
+        return new CommonResponse<>("크루 생성 성공", response);
+    }
+
+    @PatchMapping
+    @PreAuthorize("hasRole('MANAGER') or hasRole('LEADER')")
+    @Operation(summary = "크루 정보 수정", description = "크루 정보 수정하는 API 입니다.")
+    public CommonResponse<Void> updateCrewInfo(
+            @MemberCrew Crew crew,
+            @RequestParam String imageStatus,
+            @RequestPart(value = "data")CrewInfoRequest data,
+            @RequestPart(value = "image", required = false) MultipartFile image
+    ) {
+
+        crewService.updateCrew(crew, imageStatus, image, data);
+        return new CommonResponse<>("크루 정보 수정 성공");
+    }
+
+    @GetMapping("/{crewId}/invite-code")
+    @Operation(summary = "크루의 초대 코드 조회", description = "크루의 초대 코드 조회하는 API 입니다.")
+    public CommonResponse<CrewInviteCodeDto> getCrewInviteCode(@MemberCrew Crew crew) {
+
+        CrewInviteCodeDto response = crewService.getCrewInviteCode(crew);
+        return new CommonResponse<>("크루 초대 코드 조회 성공", response);
+    }
+
+    @GetMapping("/invite-code/{inviteCode}")
+    @Operation(summary = "초대 코드로 크루 조회", description = "초대 코드로 크루를 조회하는 API 입니다.")
+    public CommonResponse<CrewProfileResponse> getCrewByInviteCode(@PathVariable String inviteCode) {
+
+        CrewProfileResponse response = crewService.getCrewByInviteCode(inviteCode);
+        return new CommonResponse<>("크루 조회 성공", response);
+    }
+
+    @PostMapping("/{crewId}/join")
+    @Operation(summary = "크루 가입", description = "크루 가입하는 API 입니다.")
+    public CommonResponse<Void> joinCrew(
+            @Login Member member,
+            @PathVariable Long crewId) {
+
+        crewService.joinCrew(member, crewId);
+        return new CommonResponse<>("크루 가입 성공");
+    }
+
+    @GetMapping
+    @Operation(summary = "크루 기본 정보 조회", description = "크루 기본 정보를 조회하는 API 입니다.")
+    public CommonResponse<CrewBaseInfoResponse> getCrewBaseInfo(@MemberCrew Crew crew) {
+
+        CrewBaseInfoResponse response = crewService.getCrewBaseInfo(crew);
+        return new CommonResponse<>("크루 기본 정보 조회 성공", response);
+    }
+
+    @GetMapping("/events/weekly")
+    @Operation(summary = "weekly 기록 조회", description = "크루의 weekly 기록 조회하는 API 입니다.")
+    public CommonResponse<CrewWeeklyEventResponse> getWeeklyRecord(@MemberCrew Crew crew) {
+
+        CrewWeeklyEventResponse response = crewEventService.getCrewWeeklyEvent(crew);
+        return new CommonResponse<>("크루 주간 기록 조회 성공", response);
+    }
+
+    @GetMapping("/events/monthly")
+    @Operation(summary = "monthly 일정 조회", description = "크루의 monthly 일정 조회하는 API 입니다.")
+    public CommonResponse<CrewMonthlyCanlendarResponse> getMonthlyEvent(
+            @MemberCrew Crew crew,
+            @RequestParam int year,
+            @RequestParam int month) {
+
+        CrewMonthlyCanlendarResponse response = crewEventService.getCrewMonthlyCalendar(crew, year, month);
+        return new CommonResponse<>("크루 월간 기록 조회 성공", response);
+    }
+
+    @GetMapping("/events/upcoming")
+    @Operation(summary = "upcoming 일정 조회", description = "크루의 upcoming 일정 조회하는 API 입니다.")
+    public CommonResponse<CrewUpcomingEventResponse> getUpcomingEvent(@MemberCrew Crew crew) {
+
+        CrewUpcomingEventResponse response = crewEventService.getCrewUpcomingEvent(crew);
+        return new CommonResponse<>("크루 다가오는 일정 조회 성공", response);
+    }
+
+    @GetMapping("/members")
+    @Operation(summary = "크루원 조회", description = "크루 내 모든 크루원을 조회하는 API 입니다.")
+    public CommonResponse<Void> getCrewMember(@MemberCrew Crew crew) {
+
+        return new CommonResponse<>("크루원 조회 성공");
+    }
+}

src/main/java/run/backend/domain/crew/dto/common/CrewInviteCodeDto.java

@@ -0,0 +1,6 @@
+package run.backend.domain.crew.dto.common;
+
+public record CrewInviteCodeDto(
+        String inviteCode
+) {
+}

src/main/java/run/backend/domain/crew/dto/common/DayStatusDto.java

@@ -0,0 +1,9 @@
+package run.backend.domain.crew.dto.common;
+
+import run.backend.domain.event.enums.RunningStatus;
+
+public record DayStatusDto(
+        RunningStatus status,
+        Long eventId
+) {
+}

src/main/java/run/backend/domain/crew/dto/request/CrewInfoRequest.java

@@ -1,4 +1,7 @@
 package run.backend.domain.crew.dto.request;
 
-public record CrewInfoRequest() {
+public record CrewInfoRequest(
+        String name,
+        String description
+) {
 }

src/main/java/run/backend/domain/crew/dto/response/CrewBaseInfoResponse.java

@@ -0,0 +1,19 @@
+package run.backend.domain.crew.dto.response;
+
+import lombok.Builder;
+
+import java.math.BigDecimal;
+
+@Builder
+public record CrewBaseInfoResponse(
+
+        int rank,
+        String image,
+        String name,
+        String description,
+        Long memberCount,
+        BigDecimal monthlyDistanceTotal,
+        Long monthlyTimeTotal
+
+) {
+}

src/main/java/run/backend/domain/crew/dto/response/CrewMonthlyCanlendarResponse.java

@@ -1,9 +1,10 @@
 package run.backend.domain.crew.dto.response;
 
-import java.util.List;
+import run.backend.domain.crew.dto.common.DayStatusDto;
+import java.util.Map;
 
 public record CrewMonthlyCanlendarResponse(
-        List<CrewRecordResponse> records,
-        List<CrewEventResponse> events
+
+        Map<Integer, DayStatusDto> monthlyRunningStatus
 ) {
 }

src/main/java/run/backend/domain/crew/dto/response/CrewProfileResponse.java

@@ -1,4 +1,14 @@
 package run.backend.domain.crew.dto.response;
 
-public record CrewProfileResponse() {
+import lombok.Builder;
+
+@Builder
+public record CrewProfileResponse(
+        String crewImage,
+        String crewName,
+        String crewDescription,
+        Long memberCount,
+        String leaderImage,
+        String leaderName
+) {
 }

src/main/java/run/backend/domain/crew/dto/response/CrewWeeklyEventResponse.java

@@ -0,0 +1,13 @@
+package run.backend.domain.crew.dto.response;
+
+import run.backend.domain.crew.dto.common.DayStatusDto;
+
+import java.time.DayOfWeek;
+import java.util.Map;
+
+public record CrewWeeklyEventResponse(
+        int currentDay,
+        Map<DayOfWeek, DayStatusDto> weeklyRunningStatus
+
+) {
+}

src/main/java/run/backend/domain/crew/dto/response/EventProfileResponse.java

@@ -1,4 +1,18 @@
 package run.backend.domain.crew.dto.response;
 
-public record EventProfileResponse() {
+import lombok.Builder;
+
+import java.time.LocalDate;
+import java.time.LocalTime;
+
+@Builder
+public record EventProfileResponse(
+
+        Long eventId,
+        String title,
+        LocalDate date,
+        LocalTime startTime,
+        LocalTime endTime,
+        Long participants
+) {
 }

src/main/java/run/backend/domain/crew/entity/Crew.java

@@ -41,6 +41,22 @@ public class Crew extends BaseEntity {
     @Column(name = "monthly_score_total")
     private BigDecimal monthlyScoreTotal;
 
+    public void incrementMemberCount() {
+        this.memberCount++;
+    }
+
+    public void updateName(String newName) {
+        this.name = newName;
+    }
+
+    public void updateDescription(String newDescription) {
+        this.description = newDescription;
+    }
+
+    public void updateImage(String newImageName) {
+        this.image = newImageName;
+    }
+
     @Builder
     public Crew (
             String name,

src/main/java/run/backend/domain/crew/entity/JoinCrew.java

@@ -48,13 +48,38 @@ public void approveJoin() {
         this.joinStatus = JoinStatus.APPROVED;
     }
 
+    public static JoinCrew createLeaderJoin(Member member, Crew crew) {
+        return JoinCrew.builder()
+                .crew(crew)
+                .member(member)
+                .role(Role.LEADER)
+                .joinStatus(JoinStatus.APPROVED)
+                .joinedDate(LocalDate.now())
+                .build();
+    }
+
+    public static JoinCrew createAppliedJoin(Member member, Crew crew) {
+        return JoinCrew.builder()
+                .crew(crew)
+                .member(member)
+                .role(Role.MEMBER)
+                .joinStatus(JoinStatus.APPLIED)
+                .build();
+    }
+
     @Builder
-    public JoinCrew(
+    private JoinCrew(
             Member member,
-            Crew crew
+            Crew crew,
+            Role role,
+            JoinStatus joinStatus,
+            LocalDate joinedDate
+
     ) {
         this.crew = crew;
         this.member = member;
-        this.joinStatus = JoinStatus.APPLIED;
+        this.role = role;
+        this.joinStatus = joinStatus;
+        this.joinedDate = joinedDate;
     }
 }

src/main/java/run/backend/domain/crew/exception/CrewErrorCode.java

@@ -0,0 +1,17 @@
+package run.backend.domain.crew.exception;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import run.backend.global.exception.ErrorCode;
+
+@Getter
+@AllArgsConstructor
+public enum CrewErrorCode implements ErrorCode {
+
+    ALREADY_JOINED_CREW(7001, "이미 가입한 크루가 있습니다."),
+    NOT_FOUND_CREW(7002, "해당 크루를 찾을 수 없습니다.");
+
+
+    private final int errorCode;
+    private final String errorMessage;
+}

src/main/java/run/backend/domain/crew/exception/CrewException.java

@@ -0,0 +1,22 @@
+package run.backend.domain.crew.exception;
+
+import run.backend.global.exception.CustomException;
+
+public class CrewException extends CustomException {
+
+    public CrewException(final CrewErrorCode crewErrorCode) {
+        super(crewErrorCode);
+    }
+
+    public static class AlreadyJoinedCrew extends CrewException {
+        public AlreadyJoinedCrew() {
+            super(CrewErrorCode.ALREADY_JOINED_CREW);
+        }
+    }
+
+    public static class NotFoundCrew extends CrewException {
+        public NotFoundCrew() {
+            super(CrewErrorCode.NOT_FOUND_CREW);
+        }
+    }
+}

src/main/java/run/backend/domain/crew/mapper/CrewMapper.java

@@ -0,0 +1,42 @@
+package run.backend.domain.crew.mapper;
+
+import org.springframework.stereotype.Component;
+import run.backend.domain.crew.dto.response.CrewBaseInfoResponse;
+import run.backend.domain.crew.dto.response.CrewProfileResponse;
+import run.backend.domain.crew.entity.Crew;
+import run.backend.domain.member.entity.Member;
+
+@Component
+public class CrewMapper {
+
+    public Crew toEntity(String imageName, String name, String description) {
+        return Crew.builder()
+                .image(imageName)
+                .name(name)
+                .description(description)
+                .build();
+    }
+
+    public CrewProfileResponse toCrewProfile(Crew crew, Member leader) {
+        return CrewProfileResponse.builder()
+                .crewImage(crew.getImage())
+                .crewName(crew.getName())
+                .crewDescription(crew.getDescription())
+                .memberCount(crew.getMemberCount())
+                .leaderImage(leader.getProfileImage())
+                .leaderName(leader.getNickname())
+                .build();
+    }
+
+    public CrewBaseInfoResponse toCrewBaseInfo(int rank, Crew crew) {
+        return CrewBaseInfoResponse.builder()
+                .rank(rank)
+                .image(crew.getImage())
+                .name(crew.getName())
+                .description(crew.getDescription())
+                .memberCount(crew.getMemberCount())
+                .monthlyDistanceTotal(crew.getMonthlyDistanceTotal())
+                .monthlyTimeTotal(crew.getMonthlyTimeTotal())
+                .build();
+    }
+}