[행성 로또] 안강준 미션 제출합니다.

README.md

@@ -1 +1,86 @@
 # javascript-planetlotto-precourse
+
+## 📋 요구사항 명세서
+
+- 프로그램 실행 시 `"구입금액을 입력해 주세요."` 메세지를 출력한다.
+- 사용자로부터 `로또 구입 금액`을 입력받는다. `단위는 1,000원`이며 나누어 떨어지지 않는 경우 예외처리한다.
+- 500원 단위로 자른 개수인 n에 대해 `"n개를 구매했습니다."` 메세지를 출력한다.
+- 이후 `"당첨 번호를 입력해 주세요."` 메세지를 출력한 후, 사용자로부터 `당첨 번호`를 입력받는다. 당첨 번호는 `쉼표(,)`를 기준으로 구분한다.
+- 이후 `"보너스 번호를 입력해 주세요."` 메세지를 출력한 후, 사용자로부터 `보너스 번호`를 입력받는다.
+- 입력이 완료되면 `"당첨통계"` 메세지와 `"---"`를 출력한 후, `당첨 내역`을 출력한다.
+- 당첨 내역은 2개~5개 일치 항목을 순서대로 다음 형식에 맞춰 출력한다. (n은 실제 당첨된 개수)
+  - 5개 번호 일치 (100,000,000원) - n개
+  - 4개 번호, 보너스 번호 일치 (10,000,000원) - n개
+  - 4개 번호 일치 (1,500,000원) - n개
+  - 3개 번호 일치, 보너스 번호 일치 (500,000원) - n개
+  - 2개 번호 일치, 보너스 번호 일치 (5,000원) - n개
+  - 0개 번호 일치 (0원) - n개
+- 예외 상황 시 `[ERROR]`로 시작하는 에러 문구를 출력한 후, 해당 지점부터 다시 입력을 받는다.
+
+## ⚙️ 구현할 기능 목록
+
+### LottoGameController.js
+
+#### 1️⃣ 행성로또 게임 진행 관리 기능
+
+- [x] 사용자가 입력하는 값들은 에러 발생 시 다시 반복해서 입력받는다.
+
+### Lotto.js
+
+#### 1️⃣ 로또 번호 유효성 검사 기능
+
+- [x] 로또 번호 개수가 5개가 아니면 오류를 발생시킨다.
+- [x] 로또 번호가 정수가 아닐 때 오류를 발생시킨다.
+- [x] 로또 번호가 중복될 시 오류를 발생시킨다.
+- [x] 로또 번호는 1~30 사이의 숫자가 아닐 시 오류를 발생시킨다.
+
+#### 2️⃣ 로또 번호 및 문자열 반환 기능
+
+- [x] 로또 번호 배열을 반환한다.
+- [x] 로또 번호를 정해진 형태의 문자열로 반환한다.
+
+### LottoGame.js
+
+#### 1️⃣ 로또 배열 생성 기능
+
+- [x] 로또 구입 금액에 따른 로또 개수만큼 로또 객체을 만들어 배열로 반환한다.
+
+#### 2️⃣ 로또 객체 생성 기능
+
+- [x] 하나의 로또 객체를 만들어 반환한다.
+
+#### 3️⃣ 통계 생성 기능
+
+- [x] 로또 배열의 모든 로또에 대해 등수를 계산해서 객체로 반환한다.
+
+#### 4️⃣ 로또 배열 반환 기능
+
+- [x] 로또 배열을 반환한다.
+
+### WinningLotto.js
+
+#### 1️⃣ 등수 확인 기능
+
+- [x] 당첨 번호와 비교하여 등수를 계산해서 반환한다.
+
+#### 2️⃣ 등수 추출 기능
+
+- [x] 당첨 번호와 겹치는 번호 수와 보너스 여부를 받아 등수를 반환한다.
+
+### 🚫 예외 처리 기능
+
+- [x] 당첨 번호를 입력할 때 콤마(,) 사이의 공백은 무시한다.
+- [x] 예외 상황 시 `[ERROR]`로 시작하는 에러 문구를 출력한 후, 해당 지점부터 다시 입력을 받는다.
+
+#### ❌ [ERROR] 처리
+
+- [x] 구입 금액은 500원 단위의 숫자여야 한다.
+
+- [x] 당첨 번호는 5개여야 한다.
+- [x] 당첨 번호는 모두 정수여야 한다.
+- [x] 당첨 번호는 중복될 수 없다.
+- [x] 당첨 번호는 모두 1~30 사이의 숫자여야 한다.
+
+- [x] 보너스 번호는 정수여야 한다.
+- [x] 보너스 번호는 1~30 사이의 숫자여야 한다.
+- [x] 보너스 번호는 당첨 번호와 중복될 수 없다.

__tests__/model/LottoGameTest.js

@@ -0,0 +1,57 @@
+import { MissionUtils } from '@woowacourse/mission-utils';
+
+import LottoGame from '../../src/model/LottoGame.js';
+import WinningLotto from '../../src/model/WinningLotto.js';
+import Lotto from '../../src/model/Lotto.js';
+import { RANK } from '../../src/constants/lottoConstants.js';
+
+const mockRandoms = (numbers) => {
+  MissionUtils.Random.pickUniqueNumbersInRange = jest.fn();
+  numbers.reduce((acc, number) => {
+    return acc.mockReturnValueOnce(number);
+  }, MissionUtils.Random.pickUniqueNumbersInRange);
+};
+
+describe('LottoGame 클래스 테스트', () => {
+  beforeEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  test('구매 금액에 해당하는 개수만큼 로또를 생성해야 한다.', () => {
+    const purchaseAmount = 3000;
+    const game = new LottoGame(purchaseAmount);
+    const lottos = game.getLottos();
+
+    expect(lottos.length).toBe(6);
+  });
+
+  test('createWinningStatistics는 올바른 당첨 통계를 생성해야 한다.', () => {
+    // given
+    const mockNumbers = [
+      [1, 2, 3, 4, 5], // 1등 (5개 일치)
+      [1, 2, 3, 4, 6], // 2등 (4개 일치 + 보너스 번호 일치 O)
+      [1, 2, 3, 4, 7], // 3등 (4개 일치 + 보너스 번호 일치 X)
+    ];
+    mockRandoms(mockNumbers);
+
+    const purchaseAmount = 1500;
+    const lottoGame = new LottoGame(purchaseAmount);
+
+    const winningNumbers = [1, 2, 3, 4, 5];
+    const bonusNumber = 6;
+    const winningLotto = new WinningLotto(
+      new Lotto(winningNumbers),
+      bonusNumber,
+    );
+
+    // when
+    const winningStatistics = lottoGame.createWinningStatistics(winningLotto);
+
+    // then
+    expect(winningStatistics[RANK.FIRST]).toBe(1);
+    expect(winningStatistics[RANK.SECOND]).toBe(1);
+    expect(winningStatistics[RANK.THIRD]).toBe(1);
+    expect(winningStatistics[RANK.FOURTH]).toBe(0);
+    expect(winningStatistics[RANK.FIFTH]).toBe(0);
+  });
+});

__tests__/model/LottoTest.js

@@ -0,0 +1,61 @@
+import ERROR_MESSAGES from '../../src/constants/errorMessages.js';
+import Lotto from '../../src/model/Lotto.js';
+
+describe('Lotto 클래스 테스트', () => {
+  describe('로또 번호 유효성 검사', () => {
+    test.each([
+      {
+        description: '번호가 5개가 아닐 때 (6개)',
+        input: [1, 2, 3, 4, 5, 6],
+        expectedError: ERROR_MESSAGES.INVALID_NUMBERS_COUNT,
+      },
+      {
+        description: '번호가 5개가 아닐 때 (4개)',
+        input: [1, 2, 3, 4],
+        expectedError: ERROR_MESSAGES.INVALID_NUMBERS_COUNT,
+      },
+      {
+        description: '번호에 중복된 숫자가 있을 때',
+        input: [1, 2, 3, 4, 4],
+        expectedError: ERROR_MESSAGES.DUPLICATE_NUMBERS,
+      },
+      {
+        description: '번호에 문자가 있을 때',
+        input: [1, 2, 3, 4, 'a'],
+        expectedError: ERROR_MESSAGES.NUMBERS_MUST_BE_INTEGER,
+      },
+      {
+        description: '번호에 실수가 있을 때',
+        input: [1, 2, 3, 4, 5.5],
+        expectedError: ERROR_MESSAGES.NUMBERS_MUST_BE_INTEGER,
+      },
+      {
+        description: '번호가 1~30 범위를 벗어날 때 (0)',
+        input: [0, 1, 2, 3, 4],
+        expectedError: ERROR_MESSAGES.OUT_OF_RANGE_NUMBERS,
+      },
+
+      [
+        '번호가 1~45 범위를 벗어날 때 (31)',
+        [1, 2, 3, 4, 31],
+        ERROR_MESSAGES.OUT_OF_RANGE_NUMBERS,
+      ],
+    ])('%s, 예외가 발생해야 한다.', ({ input, expectedError }) => {
+      expect(() => new Lotto(input)).toThrow(expectedError);
+    });
+  });
+
+  describe('기능 테스트', () => {
+    test('Lotto 객체는 번호를 오름차순으로 정렬하여 저장한다.', () => {
+      const numbers = [5, 4, 3, 2, 1];
+      const lotto = new Lotto(numbers);
+      expect(lotto.getNumbers()).toEqual([1, 2, 3, 4, 5]);
+    });
+
+    test("toString 메서드는 '[1, 2, 3, 4, 5]' 형식의 문자열을 반환한다.", () => {
+      const numbers = [1, 2, 3, 4, 5];
+      const lotto = new Lotto(numbers);
+      expect(lotto.toString()).toEqual('[1, 2, 3, 4, 5]');
+    });
+  });
+});

__tests__/model/WinningLottoTest.js

@@ -0,0 +1,24 @@
+import Lotto from '../../src/model/Lotto.js';
+import WinningLotto from '../../src/model/WinningLotto.js';
+import { RANK } from '../../src/constants/lottoConstants.js';
+
+describe('WinningLotto 클래스 테스트', () => {
+  const winningNumbers = [1, 2, 3, 4, 5];
+  const bonusNumber = 6;
+  const winningLotto = new WinningLotto(new Lotto(winningNumbers), bonusNumber);
+
+  test.each([
+    ['1등(5개 일치)', new Lotto([1, 2, 3, 4, 5]), RANK.FIRST],
+    ['2등(4개 + 보너스 일치)', new Lotto([1, 2, 3, 4, 6]), RANK.SECOND],
+    ['3등(4개 일치)', new Lotto([1, 2, 3, 4, 7]), RANK.THIRD],
+    ['4등(3개 + 보너스 일치)', new Lotto([1, 2, 3, 6, 7]), RANK.FOURTH],
+    ['5등(2개 + 보너스 일치)', new Lotto([1, 2, 6, 7, 8]), RANK.FIFTH],
+    ['꽝(0개 일치)', new Lotto([7, 8, 9, 10, 11]), RANK.ZERO],
+  ])(
+    '%s일때, 올바른 등수를 반환해야 한다.',
+    (description, userLotto, expectedRank) => {
+      const rank = winningLotto.match(userLotto);
+      expect(rank).toBe(expectedRank);
+    },
+  );
+});

__tests__/utils/validateTest.js

@@ -0,0 +1,59 @@
+import Validate from '../../src/utils/validate.js';
+import Lotto from '../../src/model/Lotto.js';
+import ERROR_MESSAGES from '../../src/constants/errorMessages.js';
+
+describe('Validate 테스트', () => {
+  describe('validatePurchaseAmount 테스트', () => {
+    test.each([
+      ['숫자가 아닌 경우(abc)', 'abc'],
+      ['500원 단위가 아닌 경우(750원)', 750],
+      ['숫자와 문자가 섞여있는 경우(500j)', '500j'],
+    ])('%s, 예외가 발생해야 한다.', (description, amount) => {
+      expect(() => Validate.validatePurchaseAmount(amount)).toThrow(
+        ERROR_MESSAGES.INVALID_PURCHASE_AMOUNT,
+      );
+    });
+
+    test('유효한 구매 금액인 경우, 예외가 발생하지 않는다.', () => {
+      expect(() => Validate.validatePurchaseAmount(3000)).not.toThrow();
+    });
+  });
+
+  describe('validateBonusNumber 테스트', () => {
+    test.each([
+      ['숫자가 아닌 경우', 'a', ERROR_MESSAGES.BONUS_NUMBER_MUST_BE_INTEGER],
+      ['범위를 벗어난 경우 (0)', 0, ERROR_MESSAGES.OUT_OF_RANGE_BONUS_NUMBER],
+      ['범위를 벗어난 경우 (31)', 31, ERROR_MESSAGES.OUT_OF_RANGE_BONUS_NUMBER],
+    ])('%s, 예외가 발생해야 한다.', (description, number, expectedError) => {
+      expect(() => Validate.validateBonusNumber(number)).toThrow(expectedError);
+    });
+
+    test('유효한 보너스 번호인 경우, 예외가 발생하지 않는다.', () => {
+      expect(() => Validate.validateBonusNumber(6)).not.toThrow();
+    });
+  });
+
+  describe('validateWinningNumbersAndBonusNumber 테스트', () => {
+    test('보너스 번호가 당첨 번호와 중복될 경우, 예외가 발생해야 한다.', () => {
+      const winningNumberLotto = new Lotto([1, 2, 3, 4, 5]);
+      const bonusNumber = 5;
+      expect(() =>
+        Validate.validateWinningNumbersAndBonusNumber(
+          winningNumberLotto,
+          bonusNumber,
+        ),
+      ).toThrow(ERROR_MESSAGES.DUPLICATE_WINNING_NUMBERS_AND_BONUS_NUMBER);
+    });
+
+    test('보너스 번호가 당첨 번호와 중복되지 않는 경우, 예외가 발생하지 않는다.', () => {
+      const winningNumberLotto = new Lotto([1, 2, 3, 4, 5]);
+      const bonusNumber = 6;
+      expect(() =>
+        Validate.validateWinningNumbersAndBonusNumber(
+          winningNumberLotto,
+          bonusNumber,
+        ),
+      ).not.toThrow();
+    });
+  });
+});

src/App.js

@@ -1,5 +1,10 @@
+import LottoGameController from './controller/LottoGameController.js';
+
 class App {
-  async run() {}
+  async run() {
+    const lottoGameController = new LottoGameController();
+    await lottoGameController.play();
+  }
 }
 
 export default App;

src/constants/errorMessages.js

@@ -0,0 +1,23 @@
+import { LOTTO_RULES } from './lottoConstants.js';
+
+const ERROR_MESSAGES = Object.freeze({
+  DUPLICATE_WINNING_NUMBERS_AND_BONUS_NUMBER:
+    '보너스 번호는 당첨 번호와 중복될 수 없습니다.',
+
+  INVALID_PURCHASE_AMOUNT: `구입 금액은 ${LOTTO_RULES.PRICE}원 단위의 숫자여야 합니다.`,
+
+  INVALID_NUMBERS_COUNT: `로또 번호는 ${LOTTO_RULES.NUMBER_COUNT}개여야 합니다.`,
+  NUMBERS_MUST_BE_INTEGER: '로또 번호는 모두 정수여야 합니다',
+  DUPLICATE_NUMBERS: '로또 번호는 중복될 수 없습니다.',
+  OUT_OF_RANGE_NUMBERS: `로또 번호는 ${LOTTO_RULES.MIN_NUMBER}부터 ${LOTTO_RULES.MAX_NUMBER} 사이의 숫자여야 합니다.`,
+
+  INVALID_WINNING_NUMBERS_COUNT: `당첨 번호는 ${LOTTO_RULES.NUMBER_COUNT}개여야 합니다.`,
+  WINNING_NUMBERS_MUST_BE_INTEGER: '당첨 번호는 모두 정수여야 합니다',
+  DUPLICATE_WINNING_NUMBERS: '당첨 번호는 중복될 수 없습니다.',
+  OUT_OF_RANGE_WINNING_NUMBERS: `당첨 번호는 ${LOTTO_RULES.MIN_NUMBER}부터 ${LOTTO_RULES.MAX_NUMBER} 사이의 숫자여야 합니다.`,
+
+  BONUS_NUMBER_MUST_BE_INTEGER: '보너스 번호는 정수여야 합니다.',
+  OUT_OF_RANGE_BONUS_NUMBER: `보너스 번호는 ${LOTTO_RULES.MIN_NUMBER}부터 ${LOTTO_RULES.MAX_NUMBER} 사이의 숫자여야 합니다.`,
+});
+
+export default ERROR_MESSAGES;

src/constants/lottoConstants.js

@@ -0,0 +1,15 @@
+export const RANK = Object.freeze({
+  FIRST: 1,
+  SECOND: 2,
+  THIRD: 3,
+  FOURTH: 4,
+  FIFTH: 5,
+  ZERO: 0,
+});
+
+export const LOTTO_RULES = Object.freeze({
+  MIN_NUMBER: 1,
+  MAX_NUMBER: 30,
+  NUMBER_COUNT: 5,
+  PRICE: 500,
+});