[RELEASE] v1.0.0

src/main/java/org/umc/valuedi/domain/asset/controller/AssetController.java

@@ -4,12 +4,15 @@
 import lombok.RequiredArgsConstructor;
 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.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
+import org.umc.valuedi.domain.asset.exception.code.AssetSuccessCode;
 import org.umc.valuedi.domain.asset.dto.res.AssetResDTO;
 import org.umc.valuedi.domain.asset.dto.res.BankResDTO;
 import org.umc.valuedi.domain.asset.dto.res.CardResDTO;
-import org.umc.valuedi.domain.asset.service.AssetQueryService;
+import org.umc.valuedi.domain.asset.service.query.AssetQueryService;
+import org.umc.valuedi.domain.asset.service.command.AssetSyncFacadeService;
 import org.umc.valuedi.domain.connection.service.ConnectionQueryService;
 import org.umc.valuedi.global.apiPayload.ApiResponse;
 import org.umc.valuedi.global.apiPayload.code.GeneralSuccessCode;
@@ -25,6 +28,7 @@ public class AssetController implements AssetControllerDocs {
 
     private final ConnectionQueryService connectionQueryService;
     private final AssetQueryService assetQueryService;
+    private final AssetSyncFacadeService assetSyncFacadeService;
 
 
     @GetMapping("/cards")
@@ -65,8 +69,8 @@ public ApiResponse<BankResDTO.BankAccountListDTO> getAllBankAccounts(
         return ApiResponse.onSuccess(GeneralSuccessCode.OK, assetQueryService.getAllBankAccounts(memberId));
     }
 
-    @GetMapping("/banks/{bankCode}/accounts")
-    public ApiResponse<BankResDTO.BankAccountListDTO> getAccountsByBank(
+    @GetMapping("/banks/{bankCode}")
+    public ApiResponse<BankResDTO.BankAssetResponse> getAccountsByBank(
             @PathVariable String bankCode,
             @CurrentMember Long memberId
     ) {
@@ -79,4 +83,12 @@ public ApiResponse<AssetResDTO.AssetSummaryCountDTO> getAssetCount(
     ) {
         return ApiResponse.onSuccess(GeneralSuccessCode.OK, assetQueryService.getAssetSummaryCount(memberId));
     }
+
+    @PostMapping("/sync/refresh")
+    public ApiResponse<Void> refreshAssetSync(
+            @CurrentMember Long memberId
+    ) {
+        assetSyncFacadeService.refreshAssetSync(memberId);
+        return ApiResponse.onSuccess(AssetSuccessCode.SYNC_REQUEST_SUCCESS, null);
+    }
 }

src/main/java/org/umc/valuedi/domain/asset/controller/AssetControllerDocs.java

@@ -189,13 +189,26 @@ ApiResponse<CardResDTO.CardListDTO> getCardsByIssuer(
                                               "result": {
                                                 "accountList": [
                                                   {
+                                                    "accountId": 1,
                                                     "accountName": "KB나라사랑우대통장",
                                                     "balanceAmount": 150000,
                                                     "organization": "0004",
-                                                    "createdAt": "2024-05-20T10:00:00"
+                                                    "createdAt": "2024-05-20T10:00:00",
+                                                    "goalInfo": null
+                                                  },
+                                                  {
+                                                    "accountId": 2,
+                                                    "accountName": "KB국민ONE통장",
+                                                    "balanceAmount": 300000,
+                                                    "organization": "0004",
+                                                    "createdAt": "2024-05-21T10:00:00",
+                                                    "goalInfo": {
+                                                      "goalId": 2,
+                                                      "title": "여행"
+                                                    }
                                                   }
                                                 ],
-                                                "totalCount": 1
+                                                "totalCount": 2
                                               }
                                             }
                                     """
@@ -205,38 +218,77 @@ ApiResponse<CardResDTO.CardListDTO> getCardsByIssuer(
     })
     ApiResponse<BankResDTO.BankAccountListDTO> getAllBankAccounts(@CurrentMember Long memberId);
 
-    @Operation(summary = "은행별 계좌 목록 조회", description = "특정 은행에 연동된 계좌 목록을 조회합니다.")
+    @Operation(summary = "은행별 계좌 및 목표 목록 조회", description = "특정 은행에 연동된 계좌와 목표 목록을 조회합니다.")
     @ApiResponses({
             @io.swagger.v3.oas.annotations.responses.ApiResponse(
                     responseCode = "200",
                     description = "성공 - 은행별 계좌 목록 반환",
                     content = @Content(
                             schema = @Schema(implementation = ApiResponse.class),
-                            examples = @ExampleObject(
-                                    name = "성공 예시",
-                                    value = """
-                                            {
-                                              "isSuccess": true,
-                                              "code": "COMMON200",
-                                              "message": "성공입니다.",
-                                              "result": {
-                                                "accountList": [
-                                                  {
-                                                    "accountName": "KB나라사랑우대통장",
-                                                    "balanceAmount": 150000,
-                                                    "organization": "0004",
-                                                    "createdAt": "2024-05-20T10:00:00"
-                                                  }
-                                                ],
-                                                "totalCount": 1
-                                              }
-                                            }
-                                    """
-                            )
+                            examples = {
+                                    @ExampleObject(
+                                            name = "목표가 있는 경우",
+                                            value = """
+                                                    {
+                                                      "isSuccess": true,
+                                                      "code": "COMMON200",
+                                                      "message": "요청이 성공적으로 처리되었습니다.",
+                                                      "result": {
+                                                        "bankName": "우리은행",
+                                                        "totalBalance": 240732,
+                                                        "accountList": [
+                                                          {
+                                                            "accountId": 2,
+                                                            "accountName": "저축예금",
+                                                            "balanceAmount": 220732,
+                                                            "connectedGoalId": null
+                                                          },
+                                                          {
+                                                            "accountId": 3,
+                                                            "accountName": "청약저축",
+                                                            "balanceAmount": 20000,
+                                                            "connectedGoalId": 101
+                                                          }
+                                                        ],
+                                                        "goalList": [
+                                                          {
+                                                            "goalId": 2,
+                                                            "title": "여행행",
+                                                            "linkedAccountId": 2
+                                                          }
+                                                        ]
+                                                      }
+                                                    }
+                                            """
+                                    ),
+                                    @ExampleObject(
+                                            name = "목표가 없는 경우",
+                                            value = """
+                                                    {
+                                                      "isSuccess": true,
+                                                      "code": "COMMON200",
+                                                      "message": "요청이 성공적으로 처리되었습니다.",
+                                                      "result": {
+                                                        "bankName": "우리은행",
+                                                        "totalBalance": 100000,
+                                                        "accountList": [
+                                                          {
+                                                            "accountId": 2,
+                                                            "accountName": "저축예금",
+                                                            "balanceAmount": 100000,
+                                                            "connectedGoalId": null
+                                                          }
+                                                        ],
+                                                        "goalList": []
+                                                      }
+                                                    }
+                                            """
+                                    )
+                            }
                     )
             )
     })
-    ApiResponse<BankResDTO.BankAccountListDTO> getAccountsByBank(
+    ApiResponse<BankResDTO.BankAssetResponse> getAccountsByBank(
             @Parameter(description = "은행 코드 (예: 0020)") String organization,
             @CurrentMember Long memberId
     );
@@ -267,4 +319,52 @@ ApiResponse<BankResDTO.BankAccountListDTO> getAccountsByBank(
             )
     })
     ApiResponse<AssetResDTO.AssetSummaryCountDTO> getAssetCount(@CurrentMember Long memberId);
+
+    @Operation(
+            summary = "전체 자산 새로고침(동기화) 요청 API",
+            description = """
+                    사용자가 연동한 모든 금융사의 최신 거래내역 수집을 **백그라운드에서 시작**하도록 요청합니다.
+                    - **즉시 응답**: API는 동기화 작업을 백그라운드로 넘기고 즉시 '요청 성공' 응답을 반환합니다.
+                    - **결과 확인**: 실제 동기화 결과는 잠시 후 자산 관련 다른 API를 통해 확인해야 합니다.
+                    - **10분 쿨타임**: 마지막 동기화 시간으로부터 10분 이내에는 재호출할 수 없습니다.
+                    """
+    )
+    @ApiResponses({
+            @io.swagger.v3.oas.annotations.responses.ApiResponse(
+                    responseCode = "200",
+                    description = "성공 - 동기화 작업이 성공적으로 시작됨",
+                    content = @Content(
+                            schema = @Schema(implementation = ApiResponse.class),
+                            examples = @ExampleObject(
+                                    name = "성공 예시",
+                                    value = """
+                                            {
+                                              "isSuccess": true,
+                                              "code": "ASSET200_1",
+                                              "message": "자산 동기화 요청이 성공적으로 접수되었습니다. 잠시 후 데이터를 확인해주세요.",
+                                              "result": null
+                                            }
+                                            """
+                            )
+                    )
+            ),
+            @io.swagger.v3.oas.annotations.responses.ApiResponse(
+                    responseCode = "429",
+                    description = "실패 - 10분 쿨타임 제한",
+                    content = @Content(
+                            schema = @Schema(implementation = ApiResponse.class),
+                            examples = @ExampleObject(
+                                    name = "쿨타임 실패 예시",
+                                    value = """
+                                            {
+                                              "isSuccess": false,
+                                              "code": "ASSET429_1",
+                                              "message": "자산 동기화는 10분에 한 번만 요청할 수 있습니다."
+                                            }
+                                            """
+                            )
+                    )
+            )
+    })
+    ApiResponse<Void> refreshAssetSync(@Parameter(hidden = true) @CurrentMember Long memberId);
 }

src/main/java/org/umc/valuedi/domain/asset/converter/AssetConverter.java

@@ -1,25 +1,38 @@
 package org.umc.valuedi.domain.asset.converter;
 
-import org.springframework.stereotype.Component;
 import org.umc.valuedi.domain.asset.dto.res.AssetResDTO;
 import org.umc.valuedi.domain.asset.dto.res.BankResDTO;
 import org.umc.valuedi.domain.asset.dto.res.CardResDTO;
 import org.umc.valuedi.domain.asset.entity.BankAccount;
 import org.umc.valuedi.domain.asset.entity.Card;
+import org.umc.valuedi.domain.connection.enums.Organization;
+import org.umc.valuedi.domain.goal.entity.Goal;
 
+import java.util.ArrayList;
 import java.util.List;
 import java.util.stream.Collectors;
 
-@Component
 public class AssetConverter {
 
     // 개별 BankAccount 엔티티 -> BankAccountInfo 변환
     public static BankResDTO.BankAccountInfo toBankAccountInfo(BankAccount account) {
+        BankResDTO.GoalInfo goalInfo = null;
+        if (account.getGoal() != null) {
+            Goal goal = account.getGoal();
+
+            goalInfo = BankResDTO.GoalInfo.builder()
+                    .goalId(goal.getId())
+                    .title(goal.getTitle())
+                    .build();
+        }
+
         return BankResDTO.BankAccountInfo.builder()
+                .accountId(account.getId())
                 .accountName(account.getAccountName())
                 .balanceAmount(account.getBalanceAmount())
                 .organization(account.getCodefConnection().getOrganization()) // 기관코드 추출
                 .createdAt(account.getCreatedAt())
+                .goalInfo(goalInfo)
                 .build();
     }
 
@@ -66,4 +79,42 @@ public static AssetResDTO.AssetSummaryCountDTO toAssetSummaryCountDTO(long accou
                 .totalAssetCount(accountCount + cardCount)
                 .build();
     }
+
+    // 특정 은행의 자산 현황 응답 DTO 변환
+    public static BankResDTO.BankAssetResponse toBankAssetResponse(String organizationCode, List<BankAccount> accounts) {
+        String bankName = Organization.getNameByCode(organizationCode);
+
+        long totalBalance = 0L;
+        List<BankResDTO.AccountInfo> accountList = new ArrayList<>(accounts.size());
+        List<BankResDTO.GoalSimpleInfo> goalList = new ArrayList<>();
+
+        for (BankAccount account : accounts) {
+            totalBalance += (account.getBalanceAmount() != null ? account.getBalanceAmount() : 0L);
+
+            Goal goal = account.getGoal();
+            Long connectedGoalId = (goal != null) ? goal.getId() : null;
+
+            accountList.add(BankResDTO.AccountInfo.builder()
+                    .accountId(account.getId())
+                    .accountName(account.getAccountName())
+                    .balanceAmount(account.getBalanceAmount())
+                    .connectedGoalId(connectedGoalId)
+                    .build());
+
+            if (goal != null) {
+                goalList.add(BankResDTO.GoalSimpleInfo.builder()
+                        .goalId(goal.getId())
+                        .title(goal.getTitle())
+                        .linkedAccountId(account.getId())
+                        .build());
+            }
+        }
+
+        return BankResDTO.BankAssetResponse.builder()
+                .bankName(bankName)
+                .totalBalance(totalBalance)
+                .accountList(accountList)
+                .goalList(goalList)
+                .build();
+    }
 }

src/main/java/org/umc/valuedi/domain/asset/dto/res/AssetResDTO.java

@@ -6,6 +6,9 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+import java.time.LocalDate;
+import java.util.List;
+
 @Schema(description = "자산 통합 응답 DTO")
 public class AssetResDTO {
 
@@ -24,4 +27,28 @@ public static class AssetSummaryCountDTO {
         @Schema(description = "총 연동 자산 수 (계좌 + 카드)", example = "8")
         private Long totalAssetCount;
     }
-}
+
+    @Getter
+    @AllArgsConstructor
+    @Builder
+    @Schema(description = "AssetFetchService의 내부 처리 결과 DTO (API 응답으로 직접 사용되지 않음)")
+    public static class AssetSyncResult {
+        @Schema(description = "새로 수집된 은행 거래내역 수")
+        private int newBankTransactionCount;
+
+        @Schema(description = "새로 수집된 카드 승인내역 수")
+        private int newCardApprovalCount;
+
+        @Schema(description = "데이터 수집에 성공한 기관 목록")
+        private List<String> successOrganizations;
+
+        @Schema(description = "데이터 수집에 실패한 기관 목록")
+        private List<String> failureOrganizations;
+
+        @Schema(description = "가계부 동기화에 사용될 조회 시작일")
+        private LocalDate fromDate;
+
+        @Schema(description = "가계부 동기화에 사용될 조회 종료일")
+        private LocalDate toDate;
+    }
+}