feat: 직원 초대 및 합류 요청 기능 구현

.gitignore

@@ -52,3 +52,4 @@ src/main/generated/
 /.claude/
 CLAUDE.md
 /.ai/
+.mcp.json

src/main/java/com/dreamteam/alter/adapter/inbound/common/dto/ErrorResponse.java

@@ -47,4 +47,13 @@ public static <T> ErrorResponse<T> of(ErrorCode errorCode, T data) {
         );
     }
 
+    public static <T> ErrorResponse<T> of(ErrorCode errorCode, String message, T data) {
+        return new ErrorResponse<>(
+            String.valueOf(LocalDateTime.now()),
+            errorCode.getCode(),
+            message,
+            data
+        );
+    }
+
 }

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/controller/UserWorkspaceInvitationController.java

@@ -0,0 +1,92 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.controller;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
+import com.dreamteam.alter.adapter.inbound.common.dto.CursorPageRequestDto;
+import com.dreamteam.alter.adapter.inbound.common.dto.CursorPaginatedApiResponse;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyInvitationListFilterDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyInvitationResponseDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyJoinRequestListFilterDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyJoinRequestResponseDto;
+import com.dreamteam.alter.application.aop.AppActionContext;
+import com.dreamteam.alter.domain.user.context.AppActor;
+import com.dreamteam.alter.domain.workspace.port.inbound.*;
+import jakarta.annotation.Resource;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@PreAuthorize("hasAnyRole('USER')")
+@RequiredArgsConstructor
+@Validated
+@RequestMapping("/app")
+public class UserWorkspaceInvitationController implements UserWorkspaceInvitationControllerSpec {
+
+    @Resource(name = "sendJoinRequest")
+    private final SendJoinRequestUseCase sendJoinRequestUseCase;
+
+    @Resource(name = "getMyJoinRequestList")
+    private final GetMyJoinRequestListUseCase getMyJoinRequestListUseCase;
+
+    @Resource(name = "getMyInvitationList")
+    private final GetMyInvitationListUseCase getMyInvitationListUseCase;
+
+    @Resource(name = "acceptWorkspaceInvitation")
+    private final AcceptWorkspaceInvitationUseCase acceptWorkspaceInvitationUseCase;
+
+    @Resource(name = "declineWorkspaceInvitation")
+    private final DeclineWorkspaceInvitationUseCase declineWorkspaceInvitationUseCase;
+
+    @Override
+    @PostMapping("/workspaces/{workspaceId}/join-requests")
+    public ResponseEntity<CommonApiResponse<Void>> sendJoinRequest(
+        @PathVariable Long workspaceId
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        sendJoinRequestUseCase.execute(actor, workspaceId);
+        return ResponseEntity.status(HttpStatus.CREATED).body(CommonApiResponse.empty());
+    }
+
+    @Override
+    @GetMapping("/users/me/join-requests")
+    public ResponseEntity<CursorPaginatedApiResponse<MyJoinRequestResponseDto>> getMyJoinRequestList(
+        CursorPageRequestDto cursorPageRequest,
+        MyJoinRequestListFilterDto filter
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        return ResponseEntity.ok(getMyJoinRequestListUseCase.execute(actor, filter, cursorPageRequest));
+    }
+
+    @Override
+    @GetMapping("/users/me/invitations")
+    public ResponseEntity<CursorPaginatedApiResponse<MyInvitationResponseDto>> getMyInvitationList(
+        CursorPageRequestDto cursorPageRequest,
+        MyInvitationListFilterDto filter
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        return ResponseEntity.ok(getMyInvitationListUseCase.execute(actor, filter, cursorPageRequest));
+    }
+
+    @Override
+    @PostMapping("/users/me/invitations/{invitationId}/accept")
+    public ResponseEntity<CommonApiResponse<Void>> acceptInvitation(
+        @PathVariable Long invitationId
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        acceptWorkspaceInvitationUseCase.execute(actor, invitationId);
+        return ResponseEntity.ok(CommonApiResponse.empty());
+    }
+
+    @Override
+    @PostMapping("/users/me/invitations/{invitationId}/decline")
+    public ResponseEntity<CommonApiResponse<Void>> declineInvitation(
+        @PathVariable Long invitationId
+    ) {
+        AppActor actor = AppActionContext.getInstance().getActor();
+        declineWorkspaceInvitationUseCase.execute(actor, invitationId);
+        return ResponseEntity.ok(CommonApiResponse.empty());
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/controller/UserWorkspaceInvitationControllerSpec.java

@@ -0,0 +1,73 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.controller;
+
+import com.dreamteam.alter.adapter.inbound.common.dto.CommonApiResponse;
+import com.dreamteam.alter.adapter.inbound.common.dto.CursorPageRequestDto;
+import com.dreamteam.alter.adapter.inbound.common.dto.CursorPaginatedApiResponse;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyInvitationListFilterDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyInvitationResponseDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyJoinRequestListFilterDto;
+import com.dreamteam.alter.adapter.inbound.general.workspace.dto.MyJoinRequestResponseDto;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+
+@Tag(name = "USER - 업장 초대/합류 요청 API")
+public interface UserWorkspaceInvitationControllerSpec {
+
+    @Operation(summary = "알바생 - 업장 합류 요청 보내기", description = "특정 업장에 합류 요청을 보냅니다.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "201", description = "합류 요청 성공")
+    })
+    ResponseEntity<CommonApiResponse<Void>> sendJoinRequest(
+        @PathVariable Long workspaceId
+    );
+
+    @Operation(summary = "알바생 - 내가 보낸 합류 요청 목록 조회", description = """
+        내가 보낸 합류 요청 목록을 커서 기반 페이지네이션으로 조회합니다.
+
+        - `status` 필터 미입력 시 전체 상태 조회 (PENDING, APPROVED, REJECTED)
+        - `cursor` 미입력 시 첫 페이지 조회
+        - 응답의 `page.cursor`를 다음 요청의 `cursor`로 사용
+        """)
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "합류 요청 목록 조회 성공")
+    })
+    ResponseEntity<CursorPaginatedApiResponse<MyJoinRequestResponseDto>> getMyJoinRequestList(
+        CursorPageRequestDto cursorPageRequest,
+        MyJoinRequestListFilterDto filter
+    );
+
+    @Operation(summary = "알바생 - 내가 받은 초대 목록 조회", description = """
+        나에게 온 업장 초대 목록을 커서 기반 페이지네이션으로 조회합니다.
+
+        - `status` 필터 미입력 시 전체 상태 조회 (PENDING, ACCEPTED, DECLINED, EXPIRED)
+        - `cursor` 미입력 시 첫 페이지 조회
+        - 응답의 `page.cursor`를 다음 요청의 `cursor`로 사용
+        """)
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "초대 목록 조회 성공")
+    })
+    ResponseEntity<CursorPaginatedApiResponse<MyInvitationResponseDto>> getMyInvitationList(
+        CursorPageRequestDto cursorPageRequest,
+        MyInvitationListFilterDto filter
+    );
+
+    @Operation(summary = "알바생 - 업장 초대 수락", description = "받은 업장 초대를 수락합니다.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "초대 수락 성공")
+    })
+    ResponseEntity<CommonApiResponse<Void>> acceptInvitation(
+        @PathVariable Long invitationId
+    );
+
+    @Operation(summary = "알바생 - 업장 초대 거절", description = "받은 업장 초대를 거절합니다.")
+    @ApiResponses(value = {
+        @ApiResponse(responseCode = "200", description = "초대 거절 성공")
+    })
+    ResponseEntity<CommonApiResponse<Void>> declineInvitation(
+        @PathVariable Long invitationId
+    );
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/dto/MyInvitationListFilterDto.java

@@ -0,0 +1,31 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.dto;
+
+import com.dreamteam.alter.domain.workspace.type.BusinessInvitationStatus;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springdoc.core.annotations.ParameterObject;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDate;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@ParameterObject
+@Schema(description = "내 초대 목록 필터 DTO")
+public class MyInvitationListFilterDto {
+
+    @Parameter(description = "상태 필터 (PENDING | ACCEPTED | DECLINED | EXPIRED), 미입력 시 전체 조회")
+    private BusinessInvitationStatus status;
+
+    @Parameter(description = "조회 시작일 (ISO: 2026-03-01), 미입력 시 제한 없음")
+    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+    private LocalDate from;
+
+    @Parameter(description = "조회 종료일 (ISO: 2026-03-31, 해당일 포함), 미입력 시 제한 없음")
+    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+    private LocalDate to;
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/dto/MyInvitationResponseDto.java

@@ -0,0 +1,40 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.dto;
+
+import com.dreamteam.alter.domain.workspace.entity.BusinessInvitation;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@Builder(access = AccessLevel.PRIVATE)
+@Schema(description = "내가 받은 업장 초대 응답 DTO")
+public class MyInvitationResponseDto {
+
+    @Schema(description = "초대 ID", example = "1")
+    private Long invitationId;
+
+    @Schema(description = "업장명", example = "스타벅스 강남점")
+    private String businessName;
+
+    @Schema(description = "초대 일시", example = "2026-03-01T10:00:00")
+    private LocalDateTime invitedAt;
+
+    @Schema(description = "초대 만료 일시", example = "2026-03-08T10:00:00")
+    private LocalDateTime expiresAt;
+
+    public static MyInvitationResponseDto from(BusinessInvitation invitation) {
+        return MyInvitationResponseDto.builder()
+            .invitationId(invitation.getId())
+            .businessName(invitation.getWorkspace().getBusinessName())
+            .invitedAt(invitation.getCreatedAt())
+            .expiresAt(invitation.getExpiresAt())
+            .build();
+    }
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/dto/MyJoinRequestListFilterDto.java

@@ -0,0 +1,31 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.dto;
+
+import com.dreamteam.alter.domain.workspace.type.BusinessJoinRequestStatus;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springdoc.core.annotations.ParameterObject;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDate;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@ParameterObject
+@Schema(description = "내 합류 요청 목록 필터 DTO")
+public class MyJoinRequestListFilterDto {
+
+    @Parameter(description = "상태 필터 (PENDING | APPROVED | REJECTED), 미입력 시 전체 조회")
+    private BusinessJoinRequestStatus status;
+
+    @Parameter(description = "조회 시작일 (ISO: 2026-03-01), 미입력 시 제한 없음")
+    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+    private LocalDate from;
+
+    @Parameter(description = "조회 종료일 (ISO: 2026-03-31, 해당일 포함), 미입력 시 제한 없음")
+    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+    private LocalDate to;
+}

src/main/java/com/dreamteam/alter/adapter/inbound/general/workspace/dto/MyJoinRequestResponseDto.java

@@ -0,0 +1,41 @@
+package com.dreamteam.alter.adapter.inbound.general.workspace.dto;
+
+import com.dreamteam.alter.domain.workspace.entity.BusinessJoinRequest;
+import com.dreamteam.alter.domain.workspace.type.BusinessJoinRequestStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@Builder(access = AccessLevel.PRIVATE)
+@Schema(description = "내가 보낸 합류 요청 응답 DTO")
+public class MyJoinRequestResponseDto {
+
+    @Schema(description = "합류 요청 ID", example = "1")
+    private Long joinRequestId;
+
+    @Schema(description = "업장명", example = "스타벅스 강남점")
+    private String businessName;
+
+    @Schema(description = "합류 요청 상태", example = "PENDING")
+    private BusinessJoinRequestStatus status;
+
+    @Schema(description = "합류 요청 일시", example = "2026-03-01T10:00:00")
+    private LocalDateTime requestedAt;
+
+    public static MyJoinRequestResponseDto from(BusinessJoinRequest request) {
+        return MyJoinRequestResponseDto.builder()
+            .joinRequestId(request.getId())
+            .businessName(request.getWorkspace().getBusinessName())
+            .status(request.getStatus())
+            .requestedAt(request.getCreatedAt())
+            .build();
+    }
+}