[자판기] 김규철 미션 제출합니다.

docs/README.md

@@ -0,0 +1,93 @@
+# 3주차 미션 - 🧃 자판기
+
+## 📢 작동 순서
+
+```
+1. 자판기가 보유하고 있는 금액을 입력 받고, 동전을 무작위로 생성한다.
+    - 투입 금액으로는 동전을 생성하지 않는다.
+
+2. 자판기가 보유한 동전을 보여준다.
+
+3. 상품명, 가격, 수량을 입력하여 상품을 추가한다.
+    - 상품 가격은 100원부터 시작하며, 10원으로 나누어떨어져야 한다.
+
+4. 사용자가 금액을 투입한다.
+
+5. 투입한 금액(남은 금액)을 출력하고 구매할 상품명을 입력받는다.
+
+6. 남은 금액이 상품의 최저 가격보다 적거나, 모든 상품이 소진된 경우 바로 잔돈을 돌려준다. (종료)
+   - 반환되지 않은 금액은 자판기에 남는다.
+   - 잔돈을 반환할 수 없는 경우 잔돈으로 반환할 수 있는 금액만 반환한다.
+   - 잔돈을 돌려줄 때 현재 보유한 최소 개수의 동전으로 잔돈을 돌려준다.
+   - 지폐를 잔돈으로 반환하는 경우는 없다고 가정한다.
+```
+
+## 💻 기능 구현 목록
+
+### MachineController
+
+- 전체적인 진행이 일어나는 클래스이다.
+
+### VendingMachine
+
+- Beverages(음료)와 Money(투입 금액) 그리고 Change(잔돈)를 가지고 있다.
+- [x] 잔돈을 반환할 수 없는 경우 잔돈으로 반환할 수 있는 금액만 반환하도록 구현
+- [x] 잔돈을 돌려줄때 보유한 최소 개수의 동전으로 돌려주는 기능 구현
+- [x] 반환되지 않은 금액은 자판기에 남도록 구현
+
+### Beverage
+
+- [x] 상품명, 가격, 수량을 가지고 있다.
+
+### Beverages
+
+- Beverage의 상태와 행위를 관리하는 클래스이다.
+- 비즈니스에 종속적으로 구현한다.
+- [x] 구매 상품에 따라 수량 감소하는 기능 구현
+- [x] 남은 금액이 상품의 최저 가격보다 적거나, 모든 상품이 소진된 경우 잔돈을 반환하는 기능 구현
+
+### Money
+
+- 자판기가 현재 보유하고 있는 금액이다.
+- [x] 구매 상품에 따라 가격 감소하는 기능 구현
+
+### Change
+
+- 자판기가 가지고 있는 거스름 돈 클래스이다.
+- [x] 처음 자판기에 입력받은 돈으로 랜덤한 거스름돈 생성하는 기능 구현
+- [x] 투입 금액으로 동전 생성하지 않도록 기능 구현
+
+
+### InputView
+
+- [x] 자판기가 보유하고 있는 금액 입력받는 기능 구현
+- [x] 상품명과 가격, 수량을 입력받는 기능 구현
+- [x] 투입 금액을 입력받는 기능 구현
+- [x] 구매할 상품명을 입력받는 기능 구현
+
+### OutputView
+
+- [x] 자판기가 보유한 동전 출력하는 기능 구현
+- [x] 남은 투입 금액 출력하는 기능 구현
+- [x] 남은 자판기의 금액을 출력하는 기능 구현
+- [x] 종료 되었을때, 남은 투입 금액과 잔돈을 출력해주는 기능 구현
+
+### 예외 처리
+
+- Validator에서 점검 후, exception발생시 Exception 클래스에서 처리해준다.
+- [x] 사용자가 잘못된 값을 입력할 경우 ```IllegalArgumentException```를 발생시키고, "[ERROR]"로 시작하는 에러 메시지를 출력 후 해당 부분부터 다시 입력을 받는 기능 구현
+- [x] 입력된 ```상품 가격```이 100원부터 시작하며 10원으로 나누어 떨어지는지 예외 처리
+- [x] 입력 형식 예외 처리
+    - [x] 개별상품이 ```[]``` 로 묶여있는지 예외 처리
+    - [x] ```;```으로 구별 되는지 예외 처리
+- [x] ```투입 금액```이 정수가 아니면 예외 처리
+- [x] 입력받은 ```가격과 수량```이 정수가 아니면 예외 처리
+- [x] 입력된 ```상품 수량```이 0이하이면 예외 처리
+- [x] 존재하지 않는 상품 구매하려고 할때 예외 처리
+- [x] ```투입 금액```이 구매하려는 ```상품 가격```보다 적을 경우 구매 불가 예외 처리
+- [x] ```상품 이름``` 입력할때 공백 입력이 들어오면 예외 처리
+- [x] 상품 정보 입력할때 ```상품 이름, 가격, 수량``` 중 하나라도 입력이 안 들어오면 예외 처리
+- [x] 동일 이름의 상품을 등록할때 예외 처리
+- [x] 입력 형식에서 ```;``` 또는 ```[]``` 중복에 따른 구체적 예외 처리 사항 
+  ex) ```[콜라,1500,20];[사이다,1,10]``` 또는 ```[콜라,1500,20]];[[사이다,1,10]```또는```[콜라,1500,20];;[사이다,1,10]``` 또는 ```[콜라,1500,20];[사이다,1,10];```
+

src/main/java/vendingmachine/Application.java

@@ -1,7 +1,11 @@
 package vendingmachine;
 
+import vendingmachine.controller.MachineController;
+
 public class Application {
-    public static void main(String[] args) {
-        // TODO: 프로그램 구현
-    }
+	public static void main(String[] args) {
+		// TODO: 프로그램 구현
+		MachineController machineController = new MachineController();
+		machineController.run();
+	}
 }

src/main/java/vendingmachine/controller/MachineController.java

@@ -0,0 +1,56 @@
+package vendingmachine.controller;
+
+import vendingmachine.domain.Beverage;
+import vendingmachine.domain.Beverages;
+import vendingmachine.domain.Change;
+import vendingmachine.domain.Money;
+import vendingmachine.service.VendingMachine;
+import vendingmachine.exception.InputException;
+import vendingmachine.view.InputView;
+import vendingmachine.view.OutputView;
+
+public class MachineController {
+
+	private VendingMachine vendingMachine;
+
+	public void run() {
+		setting();
+		progress();
+		finishWithReturn();
+	}
+
+	private void setting() {
+		Change changes = new Change();
+		changes.generateChanges(InputView.getHavingMoney());
+		OutputView.printHavingMachineCoin(changes);
+		Beverages beverages = InputView.getItemPriceStock();
+		Money inputMoney = InputView.getUserInputMoney();
+		vendingMachine = new VendingMachine(beverages, changes, inputMoney);
+	}
+
+	private void progress() {
+		while (vendingMachine.canSell()) {
+			OutputView.printInputMoney(vendingMachine.getMoney());
+			try {
+				Beverage beverage = vendingMachine.findBeverageByName(InputView.getItemName());
+				validationCanBuy(beverage);
+				vendingMachine.sell(beverage);
+			} catch (IllegalArgumentException e) {
+				System.out.println(e.getMessage());
+			}
+		}
+	}
+
+	private void validationCanBuy(Beverage beverage) {
+		if (vendingMachine.canNotSellOne(beverage)) {
+			InputException.printNotEnoughMoney();
+		}
+	}
+
+	private void finishWithReturn() {
+		Change calculatedChange = vendingMachine.returnChange();
+		OutputView.printInputMoney(vendingMachine.getMoney());
+		OutputView.printExtraMoneyAndChange(calculatedChange);
+	}
+
+}

src/main/java/vendingmachine/domain/Beverage.java

@@ -0,0 +1,23 @@
+package vendingmachine.domain;
+
+public class Beverage {
+	private final String name;
+	private final int price;
+
+	public Beverage(String name, int price) {
+		this.name = name;
+		this.price = price;
+	}
+
+	public String getName() {
+		return name;
+	}
+
+	public int getPrice() {
+		return price;
+	}
+
+	public boolean isSameName(String name) {
+		return this.name.equals(name);
+	}
+}

src/main/java/vendingmachine/domain/Beverages.java

@@ -0,0 +1,28 @@
+package vendingmachine.domain;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class Beverages {
+	private final Map<Beverage, Integer> beverages;
+
+	public Beverages() {
+		beverages = new HashMap<>();
+	}
+
+	public Map<Beverage, Integer> getBeverages() {
+		return beverages;
+	}
+
+	public void add(Beverage beverage, int stock) {
+		beverages.put(beverage, stock);
+	}
+
+	public int size() {
+		return beverages.size();
+	}
+
+	public void sell(Beverage beverage) {
+		beverages.put(beverage, beverages.get(beverage) - 1);
+	}
+}

src/main/java/vendingmachine/domain/Change.java

@@ -0,0 +1,48 @@
+package vendingmachine.domain;
+
+import java.util.Map;
+import java.util.TreeMap;
+
+import camp.nextstep.edu.missionutils.Randoms;
+
+public class Change {
+
+	private final Map<Coin, Integer> changes;
+
+	public Change() {
+		changes = new TreeMap<>();
+	}
+
+	public Change(Map<Coin, Integer> changes) {
+		this.changes = changes;
+	}
+
+	public Map<Coin, Integer> getChanges() {
+		return changes;
+	}
+
+	public void generateChanges(Money money) {
+		initChanges();
+		int tmpMoney = 0;
+		while (!money.isSame(tmpMoney)) {
+			int random = Randoms.pickNumberInList(Coin.getList());
+			if (notValidChange(money, tmpMoney, random)) {
+				continue;
+			}
+			tmpMoney += random;
+			Coin coin = Coin.getCoin(random);
+			changes.put(coin, changes.get(coin) + 1);
+		}
+	}
+
+	private static boolean notValidChange(Money money, int tmpMoney, int random) {
+		return random == money.getTotal() || money.isSmaller(tmpMoney + random);
+	}
+
+	private void initChanges() {
+		this.changes.put(Coin.COIN_500, 0);
+		this.changes.put(Coin.COIN_100, 0);
+		this.changes.put(Coin.COIN_50, 0);
+		this.changes.put(Coin.COIN_10, 0);
+	}
+}

src/main/java/vendingmachine/domain/Coin.java

@@ -0,0 +1,34 @@
+package vendingmachine.domain;
+
+import java.util.Arrays;
+import java.util.List;
+
+import vendingmachine.exception.NotFoundCoinException;
+
+public enum Coin {
+	COIN_500(500),
+	COIN_100(100),
+	COIN_50(50),
+	COIN_10(10);
+
+	private final int amount;
+
+	Coin(final int amount) {
+		this.amount = amount;
+	}
+
+	public int getAmount() {
+		return amount;
+	}
+
+	public static List<Integer> getList() {
+		return Arrays.asList(COIN_10.getAmount(), COIN_50.getAmount(), COIN_100.getAmount(), COIN_500.getAmount());
+	}
+
+	public static Coin getCoin(int amount) {
+		return Arrays.stream(Coin.values())
+			.filter(coin -> coin.getAmount() == amount)
+			.findAny()
+			.orElseThrow(NotFoundCoinException::new);
+	}
+}

src/main/java/vendingmachine/domain/Money.java

@@ -0,0 +1,29 @@
+package vendingmachine.domain;
+
+public class Money {
+	private int total;
+
+	public Money() {
+		this.total = 0;
+	}
+
+	public Money(int amount) {
+		this.total = amount;
+	}
+
+	public int getTotal() {
+		return total;
+	}
+
+	public boolean isSame(int money) {
+		return total == money;
+	}
+
+	public boolean isSmaller(int money) {
+		return total < money;
+	}
+
+	public void spend(int money) {
+		total -= money;
+	}
+}