[🚀 사이클2 - 미션 (블랙잭 게임 실행)] 정콩이 미션 제출합니다.

README.md

@@ -2,62 +2,87 @@
 
 자바 언어를 활용하여 구현한 객체 지향 블랙잭 게임 프로젝트입니다.
 
----
-
 ## 🚀 프로젝트 개요
-이 프로젝트는 **MVC(Model-View-Controller) 패턴**을 기반으로 설계되었으며, 블랙잭 게임의 복잡한 도메인 로직을 객체 간의 협력으로 해결하는 데 중점을 두었습니다.<br>
-리뷰어분들이 전체적인 도메인 설계를 쉽게 이해할 수 있도록 구조와 규칙을 정리했습니다.
+
+이 프로젝트는 MVC(Model–View–Controller) 패턴을 기반으로 설계되었습니다.
+
+* Model : 블랙잭 게임의 핵심 도메인 로직
+* View : 사용자 입출력 처리
+* Controller : 게임 흐름 제어s
 
 ### ⚖️ 핵심 도메인 규칙
-1. **점수 계산**: 
+
+1. **점수 계산**
    - K, Q, J는 모두 10으로 계산합니다.
    - 에이스(Ace)는 기본 11로 계산하되, 총합이 21을 초과하면 1로 자동 전환하여 최적의 점수를 산출합니다.
-2. **승패 판정**:
-   - 21을 초과(Burst)한 참가자는 패배합니다.
+2. **승패 판정**
+   - 21을 초과하면 Burst
    - 딜러가 Burst되면 남은 플레이어는 모두 승리합니다.
    - 딜러와 점수가 같을 경우, 현재 로직상 딜러가 승리하는 규칙을 따릅니다 (무승부 없음).
-
----
+   - 딜러 카드 합이 **16 이하이면 카드 추가**
+   - 딜러 카드 합이 **17 이상이면 카드 추가 불가**
+3. **배팅 규칙**
+   - 플레이어는 게임 시작 시 **배팅 금액을 입력**
+   - **Burst 발생 시 배팅 금액을 모두 잃음**
+   - **블랙잭(처음 두 장이 21)**  
+     → 배팅 금액의 **1.5배 수익**
+   - **딜러와 플레이어 모두 블랙잭**  
+     → 배팅 금액 **환불**
+   - **딜러 Burst**  
+     → 남아있는 플레이어는 **배팅 금액만큼 승리**
 
 ## 📋 기능 요구사항
 
 ### 1. 게임 준비 단계
-- 참가자 이름을 쉼표 기준으로 입력받는다.
-- 이름 입력값의 앞 뒤 공백을 제거한다. (trim)
-- **[Exception]** 이름을 빈칸으로 입력할 경우 예외를 던진다.
-- **[Exception]** 이름은 2글자 이상 5글자 이하만 허용한다.
-- **[Exception]** 중복되는 이름은 허용하지 않는다.
-- 52장의 중복 없는 트럼프 카드 덱을 생성한다.
-- 트럼프 카드를 무작위로 섞는다.
-- 줄어든 카드를 관리하는 덱이 있어야 한다.
-- 참가자에게 2장의 카드를 나눠준다.
-- 나눠 준 카드를 출력한다.
+
+- [x] 참가자 이름을 쉼표 기준으로 입력받는다.
+- [x] 이름 입력값의 앞뒤 공백을 제거한다. (`trim`)
+- [x] 이름이 빈 값일 경우 예외를 발생시킨다.
+- [x] 이름은 **2자 이상 5자 이하**만 허용한다.
+- [x] 중복되는 이름은 허용하지 않는다.
+
+- [x] 52장의 중복 없는 트럼프 카드 덱을 생성한다.
+- [x] 트럼프 카드를 무작위로 섞는다.
+- [x] 카드를 뽑을 때마다 덱에서 제거된다.
+
+- [x] 참가자에게 **배팅 금액을 입력받는다**
+  ```shell
+   pobi의 배팅 금액은?
+   10000
+   ```
+- [X] 배팅 금액은 **음수가 될 수 없다**
+
+- [x] 참가자에게 **2장의 카드를 나눠준다**
+- [x] 나눠준 카드를 출력한다
 
 ### 2. 게임 진행 단계
-- 참가자에게 카드 속행 여부를 출력한다.
-- 참가자에게 카드 속행 여부를 입력받는다. (`y` / `n`)
-- **[Exception]** `y`, `n` 이외의 입력이 들어올 경우 예외를 던진다.
-- 카드를 새로 받을 경우 새로 뽑은 카드를 합쳐 출력한다.
-- 두 장의 카드 합계가 21을 넘지 않을 경우, 원한다면 얼마든지 카드를 계속 뽑을 수 있다.
-- 참가자의 모든 턴이 끝난 후, 딜러의 카드 합이 **16 이하**이면 1장을 더 받는다.
-- 딜러가 한 장 더 받았다는 결과를 출력한다.
-- 딜러의 카드 합이 **17 이상**이면 추가로 받을 수 없다.
 
-### 3. 결과 집계 단계
-- 딜러 → 참가자 순으로 최종 결과를 출력한다.
-    - 보유 카드 목록과 카드 합계를 함께 출력한다.
-- 승패 통계를 함께 출력한다.
+- [x] 참가자에게 카드 추가 여부를 출력한다
+- [x] 참가자에게 카드 추가 여부를 입력받는다 (`y / n`)
+- [x] `y`, `n` 이외의 입력이 들어오면 예외를 발생시킨다
+
+- [x] 카드를 새로 받을 경우 기존 카드와 함께 출력한다
+- [x] 카드 합이 21 이하이면 원하는 만큼 카드를 받을 수 있다
 
----
+- [x] 모든 플레이어 턴 종료 후 딜러 턴 진행
+- [x] 딜러 카드 합이 **16 이하이면 카드 1장 추가**
+- [x] 딜러 카드 합이 **17 이상이면 카드 추가 불가**
 
-## ✨ 설계 의도 및 특징
+- [x] 플레이어가 추가로 카드를 뽑아 21을 초과할 경우(Burst될 경우) 배팅 금액을 모두 잃는다.
+- [x] 처음 두 장의 카드 합이 21일 경우 블랙잭이되면 베팅 금액의 1.5배를 딜러에게 받는다.
+- [x] 딜러와 플레이어가 모두 동시에 블랙잭인 경우 플레이어는 베팅한 금액을 돌려받는다.
+- [x] 딜러가 21을 초과하면 그 시점까지 남아있던 플레이어들은 승리해 베팅 금액을 받는다.
 
-### 1. MVC 패턴 및 DTO 활용
-- `Controller`가 도메인 모델과 뷰 사이의 흐름을 제어합니다.
-- `ParticipantCardsDto` (Record)를 활용하여 도메인 객체의 캡슐화를 깨뜨리지 않고 UI 계층에 데이터를 안전하게 전달합니다.
+### 3. 결과 집계 단계
 
-### 2. 원시값 포장 (Value Object)
-- `Name`, `Shape`, `Number` 등 도메인에서 중요한 의미를 갖는 값들을 객체로 포장하여 유효성 검사를 수행하고 자기 자신의 상태를 책임지게 했습니다.
+- [x] 딜러 → 플레이어 순으로 카드와 점수를 출력한다
+- [x] 각 참가자의 승패를 판정한다
+- [x] 배팅 금액을 기준으로 **최종 수익을 계산한다**
+- [x] 참가자들의 최종 수익을 출력한다
+    ```shell
+   ## 최종 수익
+   딜러: 10000   
+   pobi: 10000
+   jason: -20000
+   ```
 
-### 3. 전략적인 테스트 코드
-- `CardsTest`, `DeckTest`, `ResultTest` 등을 통해 핵심 도메인 로직(점수 계산, 승패 판정)의 신뢰성을 확보했습니다.

src/main/java/Application.java

@@ -4,6 +4,5 @@ public class Application {
     public static void main(String[] args) {
         BlackJackGameController blackJackGameController = new BlackJackGameController();
         blackJackGameController.run();
-
     }
 }