feat: 회원 데이터 CRUD API

build.gradle

@@ -4,6 +4,10 @@ plugins {
     id 'io.spring.dependency-management' version '1.1.7'
 }
 
+ext {
+    springAiVersion = "1.0.0"
+}
+
 group = 'com.stcom'
 version = '0.0.1-SNAPSHOT'
 
@@ -33,6 +37,9 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-redis'
     implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
     implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8'
+    implementation 'org.springframework.ai:spring-ai-bom:1.0.0'
+    implementation 'org.springframework.ai:spring-ai-starter-model-vertex-ai-gemini'
+    implementation 'com.google.protobuf:protobuf-java:3.25.5'
     runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.11.5'
     runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.11.5' // JSON 직렬화/역직렬화에 Jackson 사용
     compileOnly 'org.projectlombok:lombok'
@@ -51,4 +58,10 @@ tasks.named('test') {
 
 jar {
     enabled = false
+}
+
+dependencyManagement {
+    imports {
+        mavenBom "org.springframework.ai:spring-ai-bom:$springAiVersion"
+    }
 }

src/main/java/com/stcom/smartmealtable/component/creditmessage/CreditMessageManager.java

@@ -0,0 +1,37 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import java.util.Map;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class CreditMessageManager {
+
+    private final GeminiCreditMessageParser geminiParser;
+
+    private final Map<String, CreditMessageParser> parsers = Map.of(
+            "KB", new KBCreditMessageParser(),
+            "NH", new NHCreditMessageParser(),
+            "SH", new SHCreditMessageParser()
+    );
+
+    public ExpenditureDto parseMessage(String message) {
+        if (message == null || message.isEmpty()) {
+            throw new IllegalArgumentException("메시지가 비어 있습니다.");
+        }
+
+        for (CreditMessageParser parser : parsers.values()) {
+            if (parser.checkVendor(message)) {
+                try {
+                    return parser.parse(message);
+                } catch (Exception ignore) {
+                    // 룰 기반 파싱 실패 – Gemini 로 fallback
+                    break;
+                }
+            }
+        }
+
+        return geminiParser.parse(message);
+    }
+}

src/main/java/com/stcom/smartmealtable/component/creditmessage/CreditMessageParser.java

@@ -0,0 +1,9 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+public interface CreditMessageParser {
+
+    boolean checkVendor(String message);
+
+    ExpenditureDto parse(String message);
+
+}

src/main/java/com/stcom/smartmealtable/component/creditmessage/ExpenditureDto.java

@@ -0,0 +1,18 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.ToString;
+
+@Data
+@AllArgsConstructor
+@ToString
+public class ExpenditureDto {
+
+    private String vendor;
+    private LocalDateTime spentDate;
+    private Long amount;
+    private String tradeName;
+
+}

src/main/java/com/stcom/smartmealtable/component/creditmessage/GeminiCreditMessageParser.java

@@ -0,0 +1,61 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import java.time.LocalDateTime;
+import lombok.RequiredArgsConstructor;
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.ai.chat.client.ChatClient.Builder;
+import org.springframework.stereotype.Component;
+
+
+@Component
+@RequiredArgsConstructor
+public class GeminiCreditMessageParser implements CreditMessageParser {
+
+    private final Builder chatClientBuilder;
+
+    private static final ObjectMapper MAPPER = new ObjectMapper();
+
+    @Override
+    public boolean checkVendor(String message) {
+        return true;
+    }
+
+    @Override
+    public ExpenditureDto parse(String message) {
+        ChatClient chatClient = chatClientBuilder.build();
+
+        String prompt = String.format("""
+                너는 대한민국의 신용카드 승인 문자(SMS)를 파싱해서 JSON 형태로 반환하는 전문가야.
+                반드시 아래 형식의 JSON 만 출력해. 설명 문구나 코드 블록 표시(```)는 절대 포함하면 안 돼.
+
+                {
+                  \"vendor\": \"<카드사 영문 약어, 예: KB, NH, SH, UNKNOWN>\",
+                  \"dateTime\": \"<ISO-8601 형식 yyyy-MM-dd'T'HH:mm:ss>\",
+                  \"amount\": <숫자형 원화 금액>,
+                  \"tradeName\": \"<가맹점명>\"
+                }
+
+                다음은 파싱 대상 SMS 원문이다:
+                %s
+                """, message);
+
+        String jsonResponse = chatClient.prompt()
+                .user(prompt)
+                .call()
+                .content();
+        try {
+            JsonNode root = MAPPER.readTree(jsonResponse);
+            String vendor = root.path("vendor").asText("UNKNOWN");
+            String dateTimeStr = root.path("dateTime").asText();
+            long amount = root.path("amount").asLong();
+            String tradeName = root.path("tradeName").asText();
+
+            LocalDateTime dateTime = LocalDateTime.parse(dateTimeStr);
+            return new ExpenditureDto(vendor, dateTime, amount, tradeName);
+        } catch (Exception e) {
+            throw new IllegalArgumentException("Gemini 파싱 실패: " + e.getMessage(), e);
+        }
+    }
+} 

src/main/java/com/stcom/smartmealtable/component/creditmessage/KBCreditMessageParser.java

@@ -0,0 +1,50 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class KBCreditMessageParser implements CreditMessageParser {
+
+    private static final Pattern KB_PATTERN = Pattern.compile(
+            // 1: MM/dd, 2: HH:mm, 3: amount, 4: trade name
+            "\\[KB국민카드]\\s*(\\d{2}/\\d{2})\\s*(\\d{2}:\\d{2})\\s*승인\\s*([\\d,]+)원\\s*[가-힣A-Za-z]*\\s*(.+)"
+    );
+
+    private static final DateTimeFormatter FORMATTER =
+            DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm");
+
+    @Override
+    public boolean checkVendor(String message) {
+        // 메시지에 "KB"가 포함되어 있는지 확인
+        return message != null && message.contains("KB");
+    }
+
+    @Override
+    public ExpenditureDto parse(String message) {
+        if (message == null) {
+            throw new IllegalArgumentException("메시지가 비어있습니다.");
+        }
+
+        Matcher matcher = KB_PATTERN.matcher(message);
+        if (!matcher.find()) {
+            throw new IllegalArgumentException("올바르지 않은 메시지 포맷입니다. " + message);
+        }
+
+        String datePart = matcher.group(1);
+        String timePart = matcher.group(2);
+        String amountPart = matcher.group(3).replace(",", ""); // “11,000” → “11000”
+        String tradeName = matcher.group(4).trim();
+
+        int currentYear = LocalDate.now().getYear();
+        LocalDateTime dateTime = LocalDateTime.parse(
+                currentYear + "/" + datePart + " " + timePart, FORMATTER
+        );
+
+        long amount = Long.parseLong(amountPart);
+
+        return new ExpenditureDto("KB", dateTime, amount, tradeName);
+    }
+}

src/main/java/com/stcom/smartmealtable/component/creditmessage/NHCreditMessageParser.java

@@ -0,0 +1,43 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class NHCreditMessageParser implements CreditMessageParser {
+
+    private static final Pattern NH_PATTERN = Pattern.compile(
+            "NH(?:농협)?카드.*?승인.*?([\\d,]+)원.*?(\\d{2}/\\d{2})\\s*(\\d{2}:\\d{2})\\s+(.+?)(?:\\s+(?:총누적|잔여).*)?$"
+    );
+
+    private static final DateTimeFormatter FMT = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm");
+
+    @Override
+    public boolean checkVendor(String message) {
+        return message != null && (message.contains("NH") || message.contains("농협"));
+    }
+
+    @Override
+    public ExpenditureDto parse(String message) {
+        if (message == null) {
+            throw new IllegalArgumentException("메시지가 비어 있습니다.");
+        }
+
+        Matcher m = NH_PATTERN.matcher(message);
+        if (!m.find()) {
+            throw new IllegalArgumentException("농협카드 SMS 형식을 인식하지 못했습니다: " + message);
+        }
+
+        long amount = Long.parseLong(m.group(1).replace(",", ""));
+        int thisYear = LocalDate.now().getYear();
+        LocalDateTime dateTime = LocalDateTime.parse(
+                thisYear + "/" + m.group(2) + " " + m.group(3), FMT
+        );
+
+        String trade = m.group(4).trim();
+
+        return new ExpenditureDto("NH", dateTime, amount, trade);
+    }
+}

src/main/java/com/stcom/smartmealtable/component/creditmessage/SHCreditMessageParser.java

@@ -0,0 +1,46 @@
+package com.stcom.smartmealtable.component.creditmessage;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class SHCreditMessageParser implements CreditMessageParser {
+
+    private static final Pattern SH_PATTERN = Pattern.compile(
+            "신한카드.*?승인.*?([\\d,]+)원(?:\\([^)]*\\))?\\s*(\\d{2}/\\d{2})\\s*(\\d{2}:\\d{2})\\s+(.+?)(?:\\s+(?:누적|잔여).*)?$"
+    );
+
+    private static final DateTimeFormatter FMT =
+            DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm");
+
+    @Override
+    public boolean checkVendor(String message) {
+        return message != null && message.contains("신한카드");
+    }
+
+    @Override
+    public ExpenditureDto parse(String message) {
+        if (message == null) {
+            throw new IllegalArgumentException("메시지가 비어 있습니다.");
+        }
+
+        Matcher m = SH_PATTERN.matcher(message);
+        if (!m.find()) {
+            throw new IllegalArgumentException("신한카드 SMS 형식을 인식하지 못했습니다: " + message);
+        }
+
+        long amount = Long.parseLong(m.group(1).replace(",", ""));
+        int year = LocalDate.now().getYear();
+        LocalDateTime dateTime = LocalDateTime.parse(
+                year + "/" + m.group(2) + " " + m.group(3), FMT
+        );
+
+        String tradeName = m.group(4).trim()
+                .replaceAll("\\s*(누적|잔여|잔액).*", "") // 혹시 남은 잔여표기가 끼어들면 제거
+                .trim();
+
+        return new ExpenditureDto("SH", dateTime, amount, tradeName);
+    }
+}

src/main/java/com/stcom/smartmealtable/domain/Budget/Budget.java

@@ -38,6 +38,7 @@ public abstract class Budget extends BaseTimeEntity {
     @Column(name = "budget_limit")
     private BigDecimal limit;
 
+
     protected Budget(MemberProfile memberProfile, BigDecimal limit) {
         this.memberProfile = memberProfile;
         this.limit = limit;
@@ -66,4 +67,15 @@ public BigDecimal getAvailableAmount() {
     public boolean isOverLimit() {
         return spendAmount.compareTo(limit) > 0;
     }
+
+    public void changeLimit(BigDecimal limit) {
+        if (limit == null || limit.signum() < 0) {
+            throw new IllegalArgumentException("예산 한도는 0 이상이어야 합니다.");
+        }
+        this.limit = limit;
+    }
+
+    public void subtractSpent(BigDecimal spent) {
+        this.spendAmount = this.spendAmount.subtract(spent);
+    }
 }

src/main/java/com/stcom/smartmealtable/domain/Budget/DailyBudget.java

@@ -21,4 +21,5 @@ public DailyBudget(MemberProfile memberProfile, BigDecimal limit,
 
     @Column(name = "daily_budget_date")
     private LocalDate date;
+
 }