[자동차 경주 미션 1,2단계] 김하은 미션 제출합니다.

.gitignore

@@ -1,7 +1,7 @@
 .gradle
 build/
 !gradle/wrapper/gradle-wrapper.jar
-!**/src/main/**/build/
+!**/src/Car/**/build/
 !**/src/test/**/build/
 
 ### IntelliJ IDEA ###
@@ -10,7 +10,7 @@ build/
 *.iml
 *.ipr
 out/
-!**/src/main/**/out/
+!**/src/Car/**/out/
 !**/src/test/**/out/
 
 ### Eclipse ###
@@ -22,7 +22,7 @@ out/
 .springBeans
 .sts4-cache
 bin/
-!**/src/main/**/bin/
+!**/src/Car/**/bin/
 !**/src/test/**/bin/
 
 ### NetBeans ###

README.md

@@ -0,0 +1,38 @@
+# 🚗 자동차 경주 게임 1,2단계 (Racing Car Game)
+
+주어진 횟수 동안 n대의 자동차가 무작위 값에 따라 전진 또는 멈추며, 최종적으로 가장 멀리 이동한 우승자를 가려내는 게임입니다.
+
+## 🎯 핵심 요구사항
+- 주어진 횟수 동안 n대의 자동차는 전진 또는 멈출 수 있다.
+- 각 자동차는 `0에서 9 사이에서 무작위 값`을 구한 후, 그 값이 **4 이상일 경우 전진**하고 **3 이하의 값이면 멈춘다.**
+- 자동차 경주 게임을 완료한 후 누가 우승했는지를 알려준다. (우승자는 한 명 이상일 수 있다.)
+
+---
+
+## 🛠️ 기능 구현 목록
+
+### 1. 자동차 (Car)
+- [x] 자동차는 이름과 현재 위치 상태를 가진다.
+- [x] 무작위 값이 4 이상일 경우 위치를 1칸 전진한다.
+- [x] 무작위 값이 3 이하일 경우 현재 위치를 유지한다.
+
+### 2. 레이싱 게임 진행 (RacingGame)
+- [x] 출전하는 자동차 명단을 관리한다.
+- [x] `java.util.Random`을 활용하여 0~9 사이의 무작위 값을 생성한다.
+- [x] 입력받은 시도 횟수만큼 각 자동차에게 무작위 값을 전달하여 경주를 진행한다.
+
+### 3. 우승자 판별
+- [x] 경주가 끝난 후, 가장 멀리 이동한 자동차의 최대 위치(maxPosition)를 구한다.
+- [x] 최대 위치와 동일한 위치에 있는 자동차(우승자)를 찾아 반환한다.
+- [x] 우승자가 여러 명일 경우 공동 우승자로 모두 반환한다.
+
+---
+
+## ✅ 테스트 구현 목록
+
+**`CarTest` (개별 자동차 책임 테스트)**
+- [x] 무작위 값이 4 이상일 때 자동차가 정상적으로 전진하는가?
+- [x] 무작위 값이 3 이하일 때 자동차가 전진하지 않고 멈추는가?
+
+**`RacingTest` (우승자 판별 로직 테스트)**
+- [x] 경주 종료 후 우승자가 여러 명일 경우 공동 우승자를 모두 정확히 반환하는가?

src/main/java/Car.java

@@ -0,0 +1,29 @@
+public class Car {
+    private final String name;
+    private int position;
+
+    private static final int MIN_FORWARD_NUMBER = 4;
+
+    public Car(String name){
+        this.name = name;
+        this.position = 0;
+    }
+
+    public void move(int randomValue){
+        if(randomValue >= MIN_FORWARD_NUMBER){
+            this.position++;
+        }
+    }
+
+    public boolean isAtPosition(int maxPosition){
+        return this.position== maxPosition;
+    }
+
+    public String getName(){
+        return this.name;
+    }
+
+    public int getPosition(){
+        return this.position;
+    }
+}

src/main/java/RacingGame.java

@@ -0,0 +1,60 @@
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Random;
+
+public class RacingGame {
+    private final List<Car> cars;
+
+    public RacingGame(List<Car> cars){
+        this.cars = cars;
+    }
+
+    public void race(int tryCount){
+        for(int i=0; i< tryCount; i++){
+            moveCars();
+        }
+    }
+
+    public void moveCars(){
+        Random random = new Random();
+        for (Car car : cars){
+            int randomValue = random.nextInt(10);
+            car.move(randomValue);
+        }
+
+    }
+
+    public List<Car> getWinners(){
+        int maxPosition = getMaxPosition();
+        return findCarsAt(maxPosition);
+    }
+
+    private int getMaxPosition(){
+        int max=0;
+        for (Car car : cars){
+            max = updateMax(max, car.getPosition());
+        }
+        return max;
+    }
+
+    private int updateMax(int currentMax, int carPosition){
+        if (carPosition > currentMax){
+            return carPosition;
+        }
+        return currentMax;
+    }
+
+    private List<Car> findCarsAt(int maxPosition){
+        List<Car> winners = new ArrayList<>();
+        for(Car car : cars){
+            addIfWinner(winners, car, maxPosition);
+        }
+        return winners;
+    }
+
+    private void addIfWinner(List<Car> winners, Car car, int maxPosition){
+        if (car.isAtPosition(maxPosition)){
+            winners.add(car);
+        }
+    }
+}

src/test/java/CarTest.java

@@ -0,0 +1,25 @@
+import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
+import static org.assertj.core.api.Assertions.assertThat;
+
+class CarTest {
+
+    @Test
+    void 무작위_값이_4_이상이면_전진한다(){
+        Car car = new Car("pobi");
+
+        car.move(4);
+
+        assertThat(car.getPosition()).isEqualTo(1);
+    }
+
+    @Test
+    void 무작위_값이_3_이하이면_멈춘다(){
+        Car car = new Car("rabbit");
+
+        car.move(3);
+
+        assertThat(car.getPosition()).isEqualTo(0);
+    }
+
+}

src/test/java/RacingTest.java

@@ -0,0 +1,23 @@
+import org.junit.jupiter.api.Test;
+import java.util.Arrays;
+import java.util.List;
+import static org.assertj.core.api.Assertions.assertThat;
+
+public class RacingTest {
+
+    @Test
+    void 우승자가_여러명일_경우_공동_우승자를_모두_반환한다(){
+        Car pobi = new Car("pobi");
+        Car crong = new Car("crong");
+        Car rabbit = new Car("rabbit");
+
+        pobi.move(4);
+        crong.move(5);
+        rabbit.move(2);
+
+        RacingGame game = new RacingGame(Arrays.asList(pobi, crong, rabbit));
+        List<Car> winners = game.getWinners();
+
+        assertThat(winners).containsExactly(pobi, crong);
+    }
+}