[🚀 사이클2 - 미션 (블랙잭 베팅)] 이든 미션 제출합니다.

README.md

@@ -1,88 +1,59 @@
 # java-blackjack
 블랙잭 미션 저장소 
 
-## 기능 요구사항
+## 구현할 기능 목록
 
----
-블랙잭 게임을 변형한 프로그램을 구현한다. 블랙잭 게임은 **딜러**와 **플레이어** 중 카드의 합이 **21** 또는 **21에 가장 가까운 숫자**를 가지는 쪽이 이기는 게임이다.
-
-카드의 숫자 계산은 카드 숫자를 기본으로 하며, 예외로 Ace는 1 또는 11로 계산할 수 있으며, King, Queen, Jack은 각각 10으로 계산한다.  
-게임을 시작하면 플레이어는 **두 장의 카드**를 지급 받으며, 두 장의 카드 숫자를 합쳐 21을 초과하지 않으면서 21에 가깝게 만들면 이긴다.  
-21을 넘지 않을 경우 원한다면 얼마든지 카드를 계속 뽑을 수 있다.  
-딜러는 처음에 받은 2장의 합계가 **16이하**이면 반드시 1장의 카드를 추가로 받아야 하고, **17점 이상**이면 추가로 받을 수 없다.  
-게임을 완료한 후 각 플레이어별로 승패를 출력한다.
-
-### Card
-#### field
-- CardNumber(Enum class)
-- CardPattern(Enum class)
-#### method
-- 숫자 검증
-- 카드 패턴 검증
----
-### Hand(1급 컬렉션)
-#### field
-- List Card
-- 카드 주인
-#### method
-- Append Card (카드 추가)
-- 전체 값(필드로 두지는 않고, 계산으로 반환) 계산 calculate
-- 문양과 숫자가 중복되는지 검사
-- Ace 값을 결정?
----
-### Member
-#### field
-- Hand
-- Role(player | dealer)
-
-#### method
-- receive
-- roleIsDealer 딜러인지 확인 후 카드 뽑을지
-- decideWinner(Member(역할이 dealer))
----
-### GameTable
-#### field
-- Members(일급 컬렉션)
+### 1. 카드 도메인 고도화
+- [x] **카드 캐싱(Flyweight Pattern)**: 52장의 카드를 미리 생성하고 재사용한다.
+- [x] **셔플 전략 주입**: 테스트 가능하도록 셔플 로직을 인터페이스로 분리한다.
 
-#### method
-- join : player 추가
-- CardResult playRound()
-- List<Card> draw(memberName, Card)
+### 2. 베팅 도메인 추가
+- [x] **금액(Money) 객체**: 베팅 금액 원시 값을 포장하고, 수익률에 따른 계산 로직을 가진다.
+- [x] **플레이어별 베팅**: 게임 시작 시 플레이어별로 베팅 금액을 입력받는다.
 
-### Service
-- holdingPlayerCards()
-```
-딜러카드: 3다이아몬드, 9클로버, 8다이아몬드 - 결과: 20
-pobi카드: 2하트, 8스페이드, A클로버 - 결과: 21
-jason카드: 7클로버, K스페이드 - 결과: 17
-```
-- finalResult()
-```
-  ## 최종 승패
-  딜러: 1승 1패
-  pobi: 승
-  jason: 패
- ```
+### 3. 상태(State) 패턴 기반 로직 리팩토링
+- [x] **상태 추상화**: `Started`, `Running`, `Finished` 등 게임의 상태를 객체로 정의한다.
+- [x] **상태 전이 구현**:
+  - `Hit` 상태에서 `draw` 호출 시 점수에 따라 `Hit` 혹은 `Bust`로 전이한다.
+  - `Hit` 상태에서 `stay` 호출 시 `Stay` 상태로 전이한다.
+- [x] **수익률(Earnings Rate) 캡슐화**:
+  - `Blackjack`: 1.5배 수익률 반환
+  - `Bust`: -1.0배 수익률 반환
+  - `Stay`: 딜러와 비교 결과에 따라 수익률 반환
 
-### Controller
-- inputView로 입력받는 멤버 추가 (join 호출)
-- GameTable에서 멤버 리스트를 받아와서 멤버별 draw의사 판별 반복
+### 4. 게임 진행 및 정산
+- [x] **수익 계산**: 게임 종료 후 플레이어의 상태에 따른 최종 수익을 계산한다.
+- [x] **딜러 최종 수익**: 모든 플레이어 수익의 합에 -1을 곱한 값을 도출한다.
 
----
-### Deck
-#### method
-- draw
-- Card Generator 52 queue에 초기화
+### 5. UI 및 출력
+- [x] 각 플레이어의 베팅 금액 입력 기능
+- [x] 최종 결과 시 플레이어별/딜러 수익 합계 출력
+
+
+## 기능 요구사항
+블랙잭 게임을 변형한 프로그램을 구현한다. 블랙잭 게임은 딜러와 플레이어 중 카드의 합이 21 또는 21에 가장 가까운 숫자를 가지는 쪽이 이기는 게임이다.
 
-## 실행 결과
+- 플레이어는 게임을 시작할 때 배팅 금액을 정해야 한다.
+- 카드의 숫자 계산은 카드 숫자를 기본으로 하며, 예외로 Ace는 1 또는 11로 계산할 수 있으며, King, Queen, Jack은 각각 10으로 계산한다.
+- 게임을 시작하면 플레이어는 두 장의 카드를 지급 받으며, 두 장의 카드 숫자를 합쳐 21을 초과하지 않으면서 21에 가깝게 만들면 이긴다. 21을 넘지 않을 경우 원한다면 얼마든지 카드를 계속 뽑을 수 있다. 단, 카드를 추가로 뽑아 21을 초과할 경우 배팅 금액을 모두 잃게 된다.
+- 처음 두 장의 카드 합이 21일 경우 블랙잭이 되면 베팅 금액의 1.5 배를 딜러에게 받는다. 딜러와 플레이어가 모두 동시에 블랙잭인 경우 플레이어는 베팅한 금액을 돌려받는다.
+- 딜러는 처음에 받은 2장의 합계가 16이하이면 반드시 1장의 카드를 추가로 받아야 하고, 17점 이상이면 추가로 받을 수 없다. 딜러가 21을 초과하면 그 시점까지 남아 있던 플레이어들은 가지고 있는 패에 상관 없이 승리해 베팅 금액을 받는다.
+
+### 실행 결과
 
 ---
 ```
 게임에 참여할 사람의 이름을 입력하세요.(쉼표 기준으로 분리)
 pobi,jason
 
+pobi의 배팅 금액은?
+10000
+
+jason의 배팅 금액은?
+20000
+
 딜러와 pobi, jason에게 2장을 나누었습니다.
-딜러카드: 3다이아몬드
+딜러: 3다이아몬드
 pobi카드: 2하트, 8스페이드
 jason카드: 7클로버, K스페이드
 
@@ -91,66 +62,67 @@ y
 pobi카드: 2하트, 8스페이드, A클로버
 pobi는 한장의 카드를 더 받겠습니까?(예는 y, 아니오는 n)
 n
-jason는 한장의 카드를 더 받겠습니까?(예는 y, 아니오는 n)
+pobi카드: 2하트, 8스페이드, A클로버
+jason은 한장의 카드를 더 받겠습니까?(예는 y, 아니오는 n)
 n
 jason카드: 7클로버, K스페이드
 
 딜러는 16이하라 한장의 카드를 더 받았습니다.
 
-딜러카드: 3다이아몬드, 9클로버, 8다이아몬드 - 결과: 20
+딜러 카드: 3다이아몬드, 9클로버, 8다이아몬드 - 결과: 20
 pobi카드: 2하트, 8스페이드, A클로버 - 결과: 21
 jason카드: 7클로버, K스페이드 - 결과: 17
 
-## 최종 승패
-딜러: 1승 1패
-pobi: 승
-jason: 패
+## 최종 수익
+딜러: 10000
+pobi: 10000 
+jason: -20000
 ```
 
 ## 프로그래밍 요구 사항
 
 ---
 - 자바 코드 컨벤션을 지키면서 프로그래밍한다.
-- 기본적으로 Java Style Guide을 원칙으로 한다.
-- indent(인덴트, 들여쓰기) depth를 2를 넘지 않도록 구현한다. 1까지만 허용한다. 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.  
-힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메서드)를 분리하면 된다.
+  - 기본적으로 Java Style Guide을 원칙으로 한다.
+- indent(인덴트, 들여쓰기) depth를 2를 넘지 않도록 구현한다. 1까지만 허용한다.
+  - 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
+  - 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메서드)를 분리하면 된다.
 - 3항 연산자를 쓰지 않는다.
-- else 예약어를 쓰지 않는다. else 예약어를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.  
-힌트: if문에서 값을 반환하는 방식으로 구현하면 else 예약어를 사용하지 않아도 된다.
+- else 예약어를 쓰지 않는다.
+  - else 예약어를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.
+  - 힌트: if문에서 값을 반환하는 방식으로 구현하면 else 예약어를 사용하지 않아도 된다.
 - 모든 기능을 TDD로 구현해 단위 테스트가 존재해야 한다. 단, UI(System.out, System.in) 로직은 제외
-- 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 구분한다.
-- UI 로직을 InputView, ResultView와 같은 클래스를 추가해 분리한다.
+  - 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 구분한다.
+  - UI 로직을 InputView, ResultView와 같은 클래스를 추가해 분리한다.
 - 함수(또는 메서드)의 길이가 10라인을 넘어가지 않도록 구현한다.
-- 함수(또는 메소드)가 한 가지 일만 하도록 최대한 작게 만들어라.
+  - 함수(또는 메소드)가 한 가지 일만 하도록 최대한 작게 만들어라.
 - 배열 대신 컬렉션을 사용한다.
 - 모든 원시 값과 문자열을 포장한다.
 - 줄여 쓰지 않는다(축약 금지).
 - 일급 컬렉션을 쓴다.
-
-## 추가된 요구 사항
-
----
 - 모든 엔티티를 작게 유지한다.
 - 3개 이상의 인스턴스 변수를 가진 클래스를 쓰지 않는다.
 - 딜러와 플레이어에서 발생하는 중복 코드를 제거해야 한다.
 
-## 미션 중 할 일
-
----
-토론 활동에서 정한 규칙을 의식하며 코드 작성  
-규칙 때문에 코드를 변경한 곳 기록
-막히는 순간 기록
 ## 미션 중 기록
 
 ---
 필수 기록:  
-[ ] 규칙을 적용해서 변경한 코드 1곳 이상  
-[ ] 테스트 작성이 어려웠던 코드 1곳 이상  
-[ ] 막힌 순간 1회 이상
+- [x] 기능 추가로 인해 수정한 위치 개수
+```markdown
+- 약 5곳 (State 클래스군, Members, Player, GameTable, BlackjackService)
+- 상태 패턴 도입 후, 새로운 규칙(수익률) 추가 시 기존 클래스를 수정하지 않고 
+  새로운 State 구현체만 만지면 되어 수정 범위가 제한됨.
+```
+- [ ] 사이클1 때보다 수정 범위가 줄었는가/늘었는가
+```markdown
 
-## 미션 완료 조건
+```
+- [ ] 규칙 적용으로 변경한 코드 1곳
+```markdown
 
----
-[ ] 요구사항 구현  
-[ ] 규칙에 의한 코드 변경 1회 이상  
-[ ] 미션 중 기록 작성  
+```
+- [ ] 테스트가 설계를 도운 순간 1회
+```markdown
+
+```

src/main/java/Main.java

@@ -1,5 +1,5 @@
-import application.BlackjackService;
 import presentation.BlackjackController;
+import presentation.ui.BlackjackView;
 import presentation.ui.InputView;
 import presentation.ui.OutputView;
 
@@ -8,8 +8,7 @@ public static void main(String[] args) {
         InputView inputView = new InputView();
         OutputView outputView = new OutputView();
 
-        BlackjackService blackjackService = new BlackjackService();
-        BlackjackController blackjackController = new BlackjackController(blackjackService, inputView, outputView);
+        BlackjackController blackjackController = new BlackjackController(new BlackjackView(inputView, outputView));
 
         blackjackController.executeGame();
     }

src/main/java/application/BlackjackService.java

@@ -1,42 +1,59 @@
 package application;
 
-import domain.Card;
+import domain.card.Card;
 import domain.GameTable;
-import application.dto.RoundResult;
-import domain.StandardDeck;
-import domain.dto.GameResult;
-import domain.dto.MemberStatus;
+import domain.member.Money;
+import dto.RoundResult;
+import domain.card.StandardDeck;
+import dto.GameResult;
+import dto.MemberStatus;
+
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 
 public class BlackjackService {
 
-    private GameTable gameTable;
+    private final GameTable gameTable;
 
-    public BlackjackService() {
+    public BlackjackService(Map<String, Integer> playerBetAmounts) {
+        Map<String, Money> playerBets = new HashMap<>();
+        for (String name : playerBetAmounts.keySet()) {
+            Money betMoney = new Money(playerBetAmounts.get(name));
+            playerBets.put(name, betMoney);
+        }
+        this.gameTable = new GameTable(playerBets, new StandardDeck());
+        gameTable.distributeInitCard();
     }
 
-    public void initializeGame(List<String> playerNames) {
-        this.gameTable = new GameTable(playerNames, new StandardDeck());
-        gameTable.distributeInitCard();
+    public boolean isFinishedByName(String playerName) {
+        return gameTable.isPlayerFinished(playerName);
     }
 
     public RoundResult startOneRound(String memberName) {
         List<Card> playerCards = gameTable.drawForMember(memberName);
 
-        boolean isBust = gameTable.checkBust(memberName);
+        boolean isBust = gameTable.isPlayerBust(memberName);
 
         return new RoundResult(playerCards, isBust);
     }
 
+    public void endPlayerRound(String playerName) {
+        gameTable.changePlayerState(playerName);
+    }
+
     public boolean checkDealerDrawable() {
         return gameTable.drawForDealer();
     }
 
     public List<MemberStatus> getMemberStatuses() {
-        return gameTable.checkMemberStatuses();
+        return gameTable.getMemberStatuses();
     }
 
     public List<GameResult> getGameResults() {
-        return gameTable.checkGameResult();
+        Map<String, Integer> profits = gameTable.getFinalProfits();
+        return profits.entrySet().stream()
+                .map(entry -> new GameResult(entry.getKey(), entry.getValue()))
+                .toList();
     }
 }

src/main/java/domain/exception/DuplicatedException.java → src/main/java/constant/exception/DuplicatedException.java

@@ -1,4 +1,4 @@
-package domain.exception;
+package constant.exception;
 
 public class DuplicatedException extends RuntimeException {
     public DuplicatedException() {