[로또] 권오웅 미션 제출합니다.

README.md

@@ -1 +1,232 @@
 # javascript-lotto-precourse
+
+## 프리코스 3주차 - 로또
+
+### 과제 진행 요구 사항
+
+- 미션은 로또 저장소를 포크하고 클론하는 것으로 시작한다.
+- 기능을 구현하기 전 README.md에 구현할 기능 목록을 정리해 추가한다.
+- Git의 커밋 단위는 앞 단계에서 README.md에 정리한 기능 목록 단위로 추가한다.
+  - [AngularJS Git Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153)을 참고해 커밋 메시지를 작성한다.
+- 자세한 과제 진행 방법은 프리코스 진행 가이드 문서를 참고한다.
+
+---
+
+### 기능 요구 사항
+
+간단한 로또 발매기를 구현한다.
+
+- 로또 번호의 숫자 범위는 1~45까지이다.
+- 1개의 로또를 발행할 때 중복되지 않는 6개의 숫자를 뽑는다.
+- 당첨 번호 추첨 시 중복되지 않는 숫자 6개와 보너스 번호 1개를 뽑는다.
+- 당첨은 1등부터 5등까지 있다. 당첨 기준과 금액은 아래와 같다.
+  - 1등: 6개 번호 일치 / 2,000,000,000원
+  - 2등: 5개 번호 + 보너스 번호 일치 / 30,000,000원
+  - 3등: 5개 번호 일치 / 1,500,000원
+  - 4등: 4개 번호 일치 / 50,000원
+  - 5등: 3개 번호 일치 / 5,000원
+- 로또 구입 금액을 입력하면 구입 금액에 해당하는 만큼 로또를 발행해야 한다.
+- 로또 1장의 가격은 1,000원이다.
+- 당첨 번호와 보너스 번호를 입력받는다.
+- 사용자가 구매한 로또 번호와 당첨 번호를 비교하여 당첨 내역 및 수익률을 출력하고 로또 게임을 종료한다.
+- 사용자가 잘못된 값을 입력할 경우 "[ERROR]"로 시작하는 메시지와 함께 Error를 발생시키고 해당 메시지를 출력한 다음 해당 지점부터 다시 입력을 받는다.
+
+---
+
+### 입출력 요구 사항
+
+### 입력
+
+- 로또 구입 금액을 입력 받는다. 구입 금액은 1,000원 단위로 입력 받으며 1,000원으로 나누어 떨어지지 않는 경우 예외 처리한다.
+
+```bash
+14000
+```
+
+- 당첨번호를 입력 받는다. 번호는 쉼표(,)를 기준으로 구분한다.
+
+```bash
+1,2,3,4,5,6
+```
+
+- 보너스 번호를 입력 받는다.
+
+```bash
+7
+```
+
+### 출력
+
+- 발행한 로또 수량 및 번호를 출력한다. 로또 번호는 오름차순으로 정렬하여 보여준다.
+
+```sql
+8개를 구매했습니다.
+[8, 21, 23, 41, 42, 43]
+[3, 5, 11, 16, 32, 38]
+[7, 11, 16, 35, 36, 44]
+[1, 8, 11, 31, 41, 42]
+[13, 14, 16, 38, 42, 45]
+[7, 11, 30, 40, 42, 43]
+[2, 13, 22, 32, 38, 45]
+[1, 3, 5, 14, 22, 45]
+```
+
+- 당첨 내역을 출력한다.
+
+```sql
+3개 일치 (5,000원) - 1개
+4개 일치 (50,000원) - 0개
+5개 일치 (1,500,000원) - 0개
+5개 일치, 보너스 볼 일치 (30,000,000원) - 0개
+6개 일치 (2,000,000,000원) - 0개
+```
+
+- 수익률은 소수점 둘째 자리에서 반올림한다. (ex. 100.0%, 51.5%, 1,000,000.0%)
+
+```sql
+총 수익률은 62.5% 입니다.
+```
+
+- 예외 상황 시 에러 문구를 출력해야 한다. 단, 에러 문구는 "[ERROR]"로 시작해야 한다.
+
+```sql
+[ERROR] 로또 번호는 1부터 45 사이의 숫자여야 합니다.
+```
+
+### 실행 결과 예시
+
+```sql
+구입금액을 입력해 주세요.
+8000
+
+8개를 구매했습니다.
+[8, 21, 23, 41, 42, 43]
+[3, 5, 11, 16, 32, 38]
+[7, 11, 16, 35, 36, 44]
+[1, 8, 11, 31, 41, 42]
+[13, 14, 16, 38, 42, 45]
+[7, 11, 30, 40, 42, 43]
+[2, 13, 22, 32, 38, 45]
+[1, 3, 5, 14, 22, 45]
+
+당첨 번호를 입력해 주세요.
+1,2,3,4,5,6
+
+보너스 번호를 입력해 주세요.
+7
+
+## 당첨 통계
+
+3개 일치 (5,000원) - 1개
+4개 일치 (50,000원) - 0개
+5개 일치 (1,500,000원) - 0개
+5개 일치, 보너스 볼 일치 (30,000,000원) - 0개
+6개 일치 (2,000,000,000원) - 0개
+총 수익률은 62.5%입니다.
+```
+
+### 기능 구현 목록
+
+- [x] 로또 구입금액을 입력 받는다.
+
+- [x] 당첨 번호를 입력 받는다.
+
+- [x] 보너스 번호를 입력 받는다.
+
+- [x] 발행한 로또 수량 및 번호를 출력한다.
+  - [x] 오름차순으로 정렬하여 출력한다.
+
+- [x] 당첨 내역을 출력한다.
+
+- [x] 수익률은 소수점 둘째 자리에서 반올림하여 출력한다.
+
+---
+
+### 예외 처리 목록
+
+- [x] 공통 예외 처리 항목
+  - [x] 사용자가 입력한 값이 숫자가 아닌 경우
+  - [x] 양의 정수가 아닌 경우
+  - [x] 로또 번호가 `1~45` 범위에 있지 않은 경우
+
+- [x] 로또 구매 금액 예외 처리 항목
+  - [x] 1,000원으로 나누어 떨어지지 않는 경우
+  - [x] 음수를 입력한 경우
+  - [x] 소수를 입력한 경우
+
+- [x] 당첨 번호 예외 처리 항목
+  - [x] 음수를 입력한 경우
+  - [x] 소수를 입력한 경우
+  - [x] 당첨 번호가 6개가 아닌 경우
+  - [x] 당첨 번호가 중복되는 경우
+  - [x] 당첨 번호에 구분자가 쉼표(`,`)가 아닌 경우
+  - [x] 당첨 번호가 `1~45` 사이의 숫자가 아닌 경우
+
+- [x] 보너스 번호 예외 처리 항목
+  - [x] 음수를 입력한 경우
+  - [x] 소수를 입력한 경우
+  - [x] 당첨 번호와 보너스 번호가 중복 되는 경우
+  - [x] 보너스 번호가 `1~45` 사이의 숫자가 아닌 경우
+
+---
+
+### 생성한 테스트 함수 목록
+
+-LottoGenerator.test.js: 로또 번호가 정상적으로 생성되는지 테스트
+
+SortLotto.test.js: 이차원 배열을 오름차순으로 정렬되는지 테스트
+
+CommonValidator.test.js: 유효성 검사에 공통적으로 사용되는 함수 테스트
+
+PurchaseCostValidator.test.js: 구매 금액과 관련된 유효성 검사 함수 테스트
+
+WinningNumberValidator.test.js: 당첨 번호와 관련된 유효성 검사 함수 테스트
+
+BonusNumberValidator.test.js: 보너스 번호와 관련된 유효성 검사 함수 테스트
+
+### 어려웠던 점
+
+기존 객체지향에 대해 깊게 알지 못했고, 그러다보니 실제로 사용하는데 어려움이 많이 있었다.
+
+하지만 하루종일 객체지향에 대해 찾아보고 디자인 패턴과 객체지향적 설계 원칙을 찾았다.
+
+그러다보니 어느샌가 코드를 쓰면서 이 부분은 어떻게 써야 하겠다가 감이 조금씩 오기 시작했다.
+
+### 파일 구조
+
+```plain
+javascript-lotto-8
+├─ .npmrc
+├─ package-lock.json
+├─ package.json
+├─ README.md
+├─ src
+│  ├─ controller
+│  │  ├─ App.js
+│  │  └─ LottoController.js
+│  ├─ index.js
+│  ├─ model
+│  │  ├─ CalculateFinalResults.js
+│  │  ├─ Lotto.js
+│  │  └─ LottoGnerator.js
+│  ├─ utils
+│  │  ├─ BonusNumberValidator.js
+│  │  ├─ CommonValidator.js
+│  │  ├─ Constants.js
+│  │  ├─ PurchaseCostValidator.js
+│  │  ├─ SortLotto.js
+│  │  └─ WinningNumberValidator.js
+│  └─ view
+│     ├─ InputView.js
+│     └─ OutputView.js
+└─ __tests__
+   ├─ ApplicationTest.js
+   ├─ BonusNumberValidator.test.js
+   ├─ CommonValidator.test.js
+   ├─ LottoGnerator.test.js
+   ├─ LottoTest.js
+   ├─ PurchaseCostValidator.test.js
+   ├─ SortLotto.test.js
+   └─ WinningNumberValidator.test.js
+
+```

__tests__/ApplicationTest.js

@@ -1,5 +1,5 @@
-import App from "../src/App.js";
-import { MissionUtils } from "@woowacourse/mission-utils";
+import App from '../src/controller/App.js';
+import { MissionUtils } from '@woowacourse/mission-utils';
 
 const mockQuestions = (inputs) => {
   MissionUtils.Console.readLineAsync = jest.fn();
@@ -19,7 +19,7 @@ const mockRandoms = (numbers) => {
 };
 
 const getLogSpy = () => {
-  const logSpy = jest.spyOn(MissionUtils.Console, "print");
+  const logSpy = jest.spyOn(MissionUtils.Console, 'print');
   logSpy.mockClear();
   return logSpy;
 };
@@ -29,7 +29,7 @@ const runException = async (input) => {
   const logSpy = getLogSpy();
 
   const RANDOM_NUMBERS_TO_END = [1, 2, 3, 4, 5, 6];
-  const INPUT_NUMBERS_TO_END = ["1000", "1,2,3,4,5,6", "7"];
+  const INPUT_NUMBERS_TO_END = ['1000', '1,2,3,4,5,6', '7'];
 
   mockRandoms([RANDOM_NUMBERS_TO_END]);
   mockQuestions([input, ...INPUT_NUMBERS_TO_END]);
@@ -39,15 +39,15 @@ const runException = async (input) => {
   await app.run();
 
   // then
-  expect(logSpy).toHaveBeenCalledWith(expect.stringContaining("[ERROR]"));
+  expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('[ERROR]'));
 };
 
-describe("로또 테스트", () => {
+describe('로또 테스트', () => {
   beforeEach(() => {
     jest.restoreAllMocks();
   });
 
-  test("기능 테스트", async () => {
+  test('기능 테스트', async () => {
     // given
     const logSpy = getLogSpy();
 
@@ -61,37 +61,37 @@ describe("로또 테스트", () => {
       [2, 13, 22, 32, 38, 45],
       [1, 3, 5, 14, 22, 45],
     ]);
-    mockQuestions(["8000", "1,2,3,4,5,6", "7"]);
+    mockQuestions(['8000', '1,2,3,4,5,6', '7']);
 
     // when
     const app = new App();
     await app.run();
 
     // then
     const logs = [
-      "8개를 구매했습니다.",
-      "[8, 21, 23, 41, 42, 43]",
-      "[3, 5, 11, 16, 32, 38]",
-      "[7, 11, 16, 35, 36, 44]",
-      "[1, 8, 11, 31, 41, 42]",
-      "[13, 14, 16, 38, 42, 45]",
-      "[7, 11, 30, 40, 42, 43]",
-      "[2, 13, 22, 32, 38, 45]",
-      "[1, 3, 5, 14, 22, 45]",
-      "3개 일치 (5,000원) - 1개",
-      "4개 일치 (50,000원) - 0개",
-      "5개 일치 (1,500,000원) - 0개",
-      "5개 일치, 보너스 볼 일치 (30,000,000원) - 0개",
-      "6개 일치 (2,000,000,000원) - 0개",
-      "총 수익률은 62.5%입니다.",
+      '8개를 구매했습니다.',
+      '[8, 21, 23, 41, 42, 43]',
+      '[3, 5, 11, 16, 32, 38]',
+      '[7, 11, 16, 35, 36, 44]',
+      '[1, 8, 11, 31, 41, 42]',
+      '[13, 14, 16, 38, 42, 45]',
+      '[7, 11, 30, 40, 42, 43]',
+      '[2, 13, 22, 32, 38, 45]',
+      '[1, 3, 5, 14, 22, 45]',
+      '3개 일치 (5,000원) - 1개',
+      '4개 일치 (50,000원) - 0개',
+      '5개 일치 (1,500,000원) - 0개',
+      '5개 일치, 보너스 볼 일치 (30,000,000원) - 0개',
+      '6개 일치 (2,000,000,000원) - 0개',
+      '총 수익률은 62.5%입니다.',
     ];
 
     logs.forEach((log) => {
       expect(logSpy).toHaveBeenCalledWith(expect.stringContaining(log));
     });
   });
 
-  test("예외 테스트", async () => {
-    await runException("1000j");
+  test('예외 테스트', async () => {
+    await runException('1000j');
   });
 });

__tests__/BonusNumberValidator.test.js

@@ -0,0 +1,39 @@
+import validateBonusNumber from '../src/utils/BonusNumberValidator.js';
+import { ERROR_MESSAGE } from '../src/utils/Constants.js';
+
+describe('BonusNumberValidator 테스트', () => {
+  const winningNumber = [1, 2, 3, 4, 5, 6];
+
+  test('보너스 번호가 숫자가 아닐 시 에러 발생 (from validateTypeNumber)', () => {
+    const input = 'a';
+    expect(() => validateBonusNumber(input, winningNumber)).toThrow(
+      `${ERROR_MESSAGE.COMMON.TYPE}\n`,
+    );
+  });
+
+  test('보너스 번호가 정수가 아닐 시 에러 발생 (from validateNumberIsInteger)', () => {
+    const input = 7.5;
+    expect(() => validateBonusNumber(input, winningNumber)).toThrow(
+      ERROR_MESSAGE.COMMON.TYPE,
+    );
+  });
+
+  test('보너스 번호가 1~45 범위를 벗어날 시 에러 발생 (from validateBonusNumberRange)', () => {
+    const input = 46;
+    expect(() => validateBonusNumber(input, winningNumber)).toThrow(
+      ERROR_MESSAGE.COMMON.RANGE,
+    );
+  });
+
+  test('보너스 번호가 당첨 번호와 중복될 시 에러 발생 (from validateWinningNumberAndBounusNumberDuplicate)', () => {
+    const input = 6; // winningNumber에 6이 포함되어 있음
+    expect(() => validateBonusNumber(input, winningNumber)).toThrow(
+      ERROR_MESSAGE.BONUS_NUMBER.DUPLICATE,
+    );
+  });
+
+  test('유효한 보너스 번호(7) 입력 시 에러가 발생하지 않음', () => {
+    const input = 7;
+    expect(() => validateBonusNumber(input, winningNumber)).not.toThrow();
+  });
+});