[로또] 박민욱 미션 제출합니다.

README.md

@@ -1 +1,244 @@
-# java-lotto-precourse
+# 🎰 로또 게임 (Lotto Game)
+
+사용자가 입력한 금액만큼 로또를 자동으로 발행하고, 당첨 번호와 보너스 번호를 기준으로 결과 통계와 수익률을 출력하는 콘솔 기반 프로그램입니다.
+
+Java 21 환경에서 동작하며, 기능별 책임을 분리해 구현하는 데 중점을 두었습니다.
+
+<br>
+<br>
+
+## 🍭 **🎯 프로젝트의 지향점 및** 방향
+
+관련된 데이터와 동작을 함께 묶어 **각 클래스가 분명한 책임을 갖도록 구성**하고, **여러 객체들이 역할에 따라 협력**하며 하나의 기능을 완성할 수 있도록 설계합니다.
+
+TDD 사이클 중 **Inside-Out 방식을 기반으로**, **입출력보다는 먼저 도메인 로직을 중심으로 개발을 시작**하고, 테스트 가능한 작은 단위부터 점차 확장해 나갑니다.
+
+<br>
+<br>
+
+## 🔁 시퀀스 다이어그램
+
+애플리케이션의 전체 동작 과정과 객체 간의 상호작용을 시각화하기 위해 시퀀스 다이어그램을 사용했습니다.
+
+```mermaid
+sequenceDiagram
+    participant U as 사용자
+    participant I as InputView
+    participant O as OutputView
+    participant C as LottoController
+    participant M as Money
+    participant F as LottoFactory
+    participant G as LottoGenerator
+    participant L as Lotto
+    participant W as WinningNumbers
+    participant R as LottoResults
+
+Note over U,C: 🎫 1단계: 로또 구매
+    loop 유효한 금액이 입력될 때까지
+        U->>I: 구입 금액 입력
+        I->>C: 금액 전달
+        C->>M: Money 생성 및 검증
+        alt 검증 성공
+            M-->>C: 유효한 Money 객체
+        else 검증 실패
+            M-->>C: IllegalArgumentException
+            C->>O: 에러 메시지 출력
+            O->>U: 에러 표시
+        end
+    end
+
+    C->>M: getLottoCount() 호출
+    M-->>C: 구매 가능한 로또 개수(count)
+
+    C->>F: generate(count) 호출
+    F->>G: generate(count) 위임
+
+    loop count번
+        G->>G: Randoms.pickUniqueNumbersInRange(1,45,6)
+        G->>L: Lotto(numbers) 생성
+    end
+    G-->>F: List<Lotto> 반환
+    F-->>C: List<Lotto> 반환
+
+    C->>O: 구매한 로또 목록 출력
+    O->>U: 로또 목록 표시
+
+Note over U,C: 🏆 2단계: 당첨 번호 입력
+    loop 유효한 당첨 번호가 입력될 때까지
+        U->>I: 당첨 번호 입력 (쉼표 구분)
+        I->>C: 당첨 번호 전달
+        C->>W: WinningNumbers 생성 및 검증
+        alt 검증 성공
+            W-->>C: 당첨 번호 객체 생성됨
+        else 검증 실패
+            W-->>C: IllegalArgumentException
+            C->>O: 에러 메시지 출력
+            O->>U: 에러 표시
+        end
+    end
+
+    loop 유효한 보너스 번호가 입력될 때까지
+        U->>I: 보너스 번호 입력
+        I->>C: 보너스 번호 전달
+        C->>W: 보너스 번호 설정 및 검증
+        alt 검증 성공
+            W-->>C: 최종 당첨 번호 객체 완성
+        else 검증 실패
+            W-->>C: IllegalArgumentException
+            C->>O: 에러 메시지 출력
+            O->>U: 에러 표시
+        end
+    end
+    Note over U,C: 📊 3단계: 결과 분석 및 출력
+    C->>R: LottoResults 생성 (List<Lotto>, WinningNumbers)
+    loop 각 로또에 대해
+        R->>R: 등수별 카운트 증가
+        R->>R: 총 상금 누적
+    end
+    C->>R: calculateYield(구입 금액) 호출
+    R-->>C: 수익률 반환
+    C->>O: 당첨 통계 출력
+    O->>U: 통계 표시
+    C->>O: 수익률 출력
+    O->>U: 수익률 표시
+```
+
+<br>
+<br>
+
+## **🧱 객체 역할 요약**
+
+| 객체 이름                  | 역할(책임)                                      | 보유 값(상태)                        | 주요 행위                                                            |
+|------------------------|---------------------------------------------|---------------------------------|------------------------------------------------------------------|
+| `Money`                | 구입 금액을 표현하고 관련 규칙을 검증하는 값 객체                | * 구입 금액                         | - 금액 유효성 검사, 구매 가능한 로또 수 계산                                      |
+| `Lotto`                | 로또 한 장을 표현하며 번호 규칙(개수, 범위, 중복)의 불변성을 보장     | * 6개의 로또 번호                     | - 번호 정렬 및 중복 검사, 당첨 번호와 일치 개수 계산, 보너스 포함 여부 확인                   |
+| `LottoGenerator`       | 로또 번호 생성 전략을 추상화하는 인터페이스                    |                                 | - 요청된 개수만큼 `Lotto` 리스트 생성                                        |
+| `RandomLottoGenerator` | 랜덤 전략으로 로또 규칙에 맞는 번호를 생성                    |                                 | - `Randoms.pickUniqueNumbersInRange()`를 사용해 번호 생성, `Lotto` 객체 생성 |
+| `LottoFactory`         | 로또 생성 전략(`LottoGenerator`)에 생성 요청을 위임하는 팩토리 | * `LottoGenerator` 구현체          | - 생성기 null 검증, 생성 개수 검증, 생성기에 로또 생성 위임                           |
+| `WinningNumbers`       | 당첨 번호와 보너스 번호를 가지며 관련 규칙(개수, 범위, 중복)을 책임짐   | * 6개 당첨 번호, 1개 보너스 번호           | - 당첨 번호 유효성 검사, 보너스 번호 유효성 검사 및 중복 확인                            |
+| `LottoRank`            | 당첨 등수(1~5등, 꽝)의 조건(일치 개수, 보너스)과 상금을 정의      | * Enum(일치 개수, 보너스 포함 여부, 당첨 금액) | - 일치 수/보너스 포함 여부로 등수 반환, 상금 반환                                   |
+| `LottoResults`         | 전체 당첨 결과를 집계하고 최종 수익률을 계산                   | * 등수별 당첨 횟수, 누적 상금              | - 각 로또에 대한 등수 계산, 당첨 결과 누적, 수익률 계산                               |
+| `InputView`            | 사용자로부터 입력을 받는 모든 로직을 담당                     | * 입력 접두사                        | - 사용자로부터 입력을 받음, `Console.readLine()` 사용                         |
+| `OutputView`           | 사용자에게 정보를 출력하는 모든 로직을 담당                    | * 출력 접두사                        | - 구매한 로또 목록 출력, 당첨 결과 출력, 수익률 출력                                 |
+| `InputValidator`       | 문자열 입력을 숫자/리스트로 변환하고 형식을 검증하는 유틸리티          | -                               | - 구입 금액/당첨 번호/보너스 번호 문자열 파싱, 공백 및 숫자 형식 검증                       |
+| `LottoController`      | 애플리케이션의 전체 실행 흐름을 조율. View와 Domain 객체들을 연결  |                                 | - 전체 흐름 제어                                                       |
+
+<br>
+<br>
+
+## **🚰 구현 순서 (Inside-Out 방식)**
+
+### **1단계: 핵심 도메인 모델 구현**
+
+> 비즈니스의 가장 본질적인 규칙과 데이터를 정의하고 테스트합니다.
+>
+
+- `Money`: 금액을 표현하고, 1,000원 단위 검증 및 로또 구매 가능 개수 계산 책임을 가집니다.
+- `Lotto`: 로또 한 장(6개 번호)을 표현하며, 번호 개수, 범위, 중복 등 규칙의 불변성을 보장합니다.
+
+### **2단계: 당첨 규칙 및 판정 로직 구현**
+
+> 당첨을 결정하는 기준과 로직을 구현합니다.
+>
+
+- `WinningNumbers`: 당첨 번호(6개)와 보너스 번호(1개)를 가지며, 관련된 유효성 검증 책임을 가집니다.
+- `LottoRank`: 5개 등수와 '꽝'에 대한 조건(일치 개수, 보너스 여부)과 상금을 `enum`으로 정의합니다. **(등수 판정 로직 포함)**
+
+### **3단계: 결과 집계 및 분석 로직 구현**
+
+> 구매한 로또들의 결과를 종합하여 통계를 내는 책임을 구현합니다.
+>
+
+- `LottoResults`: 구매한 모든 `Lotto`와 `WinningNumbers`를 비교하여, 등수별 당첨 횟수를 집계하고 최종 수익률을 계산합니다.
+
+### **4단계: 로또 생성 로직 구현**
+
+> 도메인 규칙에 따라 로또를 생성하는 책임을 구현합니다.
+>
+
+- `LottoFactory`: `LottoGenerator`를 사용해 규칙에 맞는 로또 목록을 생성합니다.
+
+### **5단계: 입출력(UI) 계층 구현**
+
+> 사용자와 상호작용하는 부분을 구현합니다.
+>
+
+- `InputView`: 사용자로부터 구입 금액, 당첨 번호, 보너스 번호를 입력받는 책임을 가집니다.
+- `OutputView`: 구매 내역, 당첨 통계, 수익률, 에러 메시지 등 모든 출력 내용을 형식에 맞게 보여주는 책임을 가집니다.
+- `InputValidator`: `InputView`를 통해 들어온 사용자 입력 값의 형식(숫자인지, 쉼표로 구분되는지 등)을 검증합니다.
+
+### **6단계: 애플리케이션 통합 및 실행**
+
+> 구현된 모든 객체를 조립하여 프로그램을 완성합니다.
+>
+
+- `LottoController`: 전체 애플리케이션의 실행 흐름(로또 구매 → 당첨 번호 입력 → 결과 발표)을 제어하고, 예외 발생 시 재입력 로직을 처리합니다.
+- `Application`: 프로그램의 시작점(`main` 메서드)으로, `LottoController`를 생성하고 실행합니다.
+
+### **7단계: 리팩토링 및 최종 검토**
+
+> 코드 품질을 개선하고 요구사항을 최종 점검합니다.
+>
+
+- `ValidationUtil`, `Retry` 등 중복 로직을 유틸리티 클래스로 추출합니다.
+- 전체 코드에 대해 프로그래밍 제약 조건(들여쓰기, 메서드 길이 등) 준수 여부를 검토합니다.
+
+<br>
+<br>
+
+## 📋 예외 처리
+
+사용자의 입력 오류로 예외가 발생하면  **`[ERROR] ...` 로 시작하는 에러 메시지를 사용자에게 출력하고 해당 입력부터 다시 입력을 진행할 수 있도록 합니다.**
+
+| 예외 상황                      | 에러 메시지                                    |
+|----------------------------|-------------------------------------------|
+| 당첨 결과를 계산할 로또 목록이 null인 경우 | `[ERROR] 당첨 결과를 계산할 로또 목록은 null일 수 없습니다.` |
+| 로또 목록에 null이 포함된 경우        | `[ERROR] 로또 목록에 null이 포함될 수 없습니다.`        |
+| 당첨 번호가 null인 경우            | `[ERROR] 당첨 번호는 null일 수 없습니다.`            |
+| 수익률 계산시 구입금액이 0 이하인 경우     | `[ERROR] 구입 금액은 0보다 커야 합니다.`              |
+| 구입 금액이 0 이하인 경우            | `[ERROR] 구입 금액은 0보다 커야 합니다.`              |
+| 구입 금액이 1,000원 단위가 아닌 경우    | `[ERROR] 1,000원 단위로 입력해 주세요.`             |
+| 로또 번호 리스트가 null인 경우        | `[ERROR] 로또 번호는 null일 수 없습니다.`            |
+| 비교할 로또 번호 리스트가 null인 경우    | `[ERROR] 비교할 로또가 null일 수 없습니다.`           |
+| 로또 번호가 6개가 아닌 경우           | `[ERROR] 로또 번호는 6개여야 합니다.`                |
+| 로또 번호에 중복이 있는 경우           | `[ERROR] 로또 번호는 중복될 수 없습니다.`              |
+| 로또 번호가 1~45 범위를 벗어나는 경우    | `[ERROR] 로또 번호는 1부터 45 사이여야 합니다.`         |
+| 보너스 번호가 1~45 범위를 벗어난 경우    | `[ERROR] 보너스 번호는 1부터 45 사이여야 합니다.`        |
+| 보너스 번호가 당첨 번호와 중복되는 경우     | `[ERROR] 보너스 번호는 당첨 번호와 중복될 수 없습니다.`      |
+| 로또 생성기가 null인 경우           | `[ERROR] 로또 생성기는 null일 수 없습니다.`           |
+| 로또 생성 개수가 0 이하인 경우         | `[ERROR] 로또 생성 개수는 1개 이상이어야 합니다.`         |
+| 입력 문자열이 null 또는 공백인 경우     | `[ERROR] 입력은 비어 있을 수 없습니다.`               |
+| 구입 금액 입력이 숫자가 아닌 경우        | `[ERROR] 구입 금액은 숫자여야 합니다.`                |
+| 당첨 번호 입력에 숫자가 아닌 값이 포함된 경우 | `[ERROR] 당첨 번호는 숫자여야 합니다.`                |
+| 보너스 번호 입력이 숫자가 아닌 경우       | `[ERROR] 보너스 번호는 숫자여야 합니다.`               |
+
+<br>
+<br>
+
+## ⚙️ 개발 및 기술 제약
+
+- 이 프로그램은 **Java 21**에서 실행되어야 한다.
+- 프로그램의 시작점은 **`Application` 클래스의 `main()`** 메서드여야 한다.
+- **제공된 `build.gradle` 파일은 수정할 수 없다.** 외부 라이브러리를 추가하지 않는다.
+- 로또 번호 생성은 **`camp.nextstep.edu.missionutils.Randoms.pickUniqueNumbersInRange(1, 45, 6)`** 을 사용한다.
+- 사용자 입력은 **`camp.nextstep.edu.missionutils.Console.readLine()`** 으로만 받는다.
+- 프로그램 종료를 위해 **`System.exit()`를 호출해서는 안 된다.**
+- 들여쓰기는 **2단계 이내**로 유지한다.
+- **`else` 문, `switch/case`, 삼항 연산자**는 사용하지 않는다.
+- 하나의 메서드는 **한 가지 일만** 하도록 작성하고, **15줄을 넘기지 않도록** 한다.
+- 제공된 `Lotto` 클래스에는 **필드를 추가하지 않는다.**
+
+<br>
+<br>
+
+## 📝 구현 기록 / 고민 정보
+
+구현 과정에서 배우고 고민했던 것들을 기록하는 공간입니다.
+
+- [도메인 설계시 고려했던 것](https://github.com/JohnPrk/java-lotto-8/issues/1)
+- [Inside-Out vs Outside-In TDD 선택 이유](https://github.com/JohnPrk/java-lotto-8/issues/2)
+- [Supplier는 무엇인가?](https://github.com/JohnPrk/java-lotto-8/issues/3)
+- [2023년 구현 vs 지금 구현 비교[회고]](https://github.com/JohnPrk/java-lotto-8/issues/4)
+
+<br>
+<br>

src/main/java/lotto/Application.java

@@ -1,7 +1,14 @@
 package lotto;
 
+import lotto.controller.LottoController;
+import lotto.domain.LottoFactory;
+import lotto.domain.RandomLottoGenerator;
+
 public class Application {
+
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        LottoFactory lottoFactory = new LottoFactory(new RandomLottoGenerator());
+        LottoController controller = new LottoController(lottoFactory);
+        controller.run();
     }
 }

src/main/java/lotto/controller/LottoController.java

@@ -0,0 +1,71 @@
+package lotto.controller;
+
+import lotto.domain.*;
+import lotto.view.InputView;
+import lotto.view.OutputView;
+
+import java.util.List;
+
+public class LottoController {
+
+    private final LottoFactory lottoFactory;
+
+    public LottoController(LottoFactory lottoFactory) {
+        this.lottoFactory = lottoFactory;
+    }
+
+    public void run() {
+        Money money = readMoney();
+        int lottoCount = money.getLottoCount();
+        List<Lotto> lottos = lottoFactory.generate(lottoCount);
+        OutputView.printLottos(lottos);
+        WinningNumbers winningNumbers = readWinningNumbers();
+        LottoResults results = new LottoResults(lottos, winningNumbers);
+        OutputView.printStatistics(results);
+        double yield = results.calculateYield(money.getAmount());
+        OutputView.printYield(yield);
+    }
+
+    private Money readMoney() {
+        while (true) {
+            try {
+                int purchaseAmount = InputView.readPurchaseAmount();
+                return new Money(purchaseAmount);
+            } catch (IllegalArgumentException e) {
+                OutputView.printError(e.getMessage());
+            }
+        }
+    }
+
+    private WinningNumbers readWinningNumbers() {
+        while (true) {
+            try {
+                List<Integer> numbers = readWinningNumberList();
+                int bonus = readBonusNumber();
+                return new WinningNumbers(numbers, bonus);
+            } catch (IllegalArgumentException e) {
+                OutputView.printError(e.getMessage());
+            }
+        }
+    }
+
+    private List<Integer> readWinningNumberList() {
+        while (true) {
+            try {
+                return InputView.readWinningNumbers();
+            } catch (IllegalArgumentException e) {
+                OutputView.printError(e.getMessage());
+            }
+        }
+    }
+
+    private int readBonusNumber() {
+        while (true) {
+            try {
+                return InputView.readBonusNumber();
+            } catch (IllegalArgumentException e) {
+                OutputView.printError(e.getMessage());
+            }
+        }
+    }
+}