우아한테크코스 6기 최종 코딩 테스트: OnCall 리뷰용 브랜치

docs/README.md

@@ -0,0 +1,74 @@
+# 우아한테크코스 최종 코딩 테스트 미션: 온콜
+
+### 요구사항 꺼내기
+
+대기는 순번에 따른다. 순번은 평일/주말 모두 존재하며, 각 사원은 평일과 주말에 1번 등장해야 한다.
+
+연속 2일 대기할 수 없으며, 배치했을 때 2일이 되는 경우, 다음 날의 순번과 교체한다.
+
+휴일은 토요일/일요일/법정공휴일이다.
+
+2월은 28일까지 존재한다. 윤년은 고려하지 않는다.
+
+## [도메인](#도메인)
+
+### 사원
+
+- [x] 이름은 5자 이내이다
+
+### 근무표
+
+평일 및 휴일을 같은 클래스를 사용한다
+
+- [x] 최소 5명, 최대 35명의 사원으로 이루어져 있다
+- [x] 중복되는 사람이 없어야 한다
+- [x] 서로 다른 근무표에 대해, 같은 인원으로 이루어져있는지 확인한다
+- [x] 다음 순번의 근무자를 알아낸다
+- [x] 다다음 순번의 근무자를 알아낸다
+
+### 평일 및 휴일 최종 근무 순번
+
+- [x] 평일 / 휴일에 해당하는 근무 순번을 가지고 있다
+- [x] 평일 / 휴일에 해당하는 다음 순번의 근무자를 알아낸다
+- [x] 평일 / 휴일에 해당하는 다다음 순번의 근무자를 알아낸다
+
+### 캘린더
+- [x] 월과 첫 요일이 주어지면, 해당 월을 구축한다
+- [x] 그 달의 마지막 날을 알아낸다
+
+#### 날짜
+하루를 나타내는 클래스
+- [x] 출력 형식에 맞게 구성한다
+- [x] 날짜가 주어지면, 해당 날짜가 휴일인지 아닌지 판단한다.
+
+### 일일 근무자
+- [x] 사원, 날짜로 이루어져 있다
+- [x] 출력 형식에 맞게 구성한다
+
+### 월간 근무자
+최종적으로 사용자에게 보여질 클래스이며 서비스가 만들게 될 객체
+- [x] 각 일일 근무자로 이루어져 있다
+- [x] 출력 형식에 맞게 구성한다
+
+## [로직 수행 클래스](#로직-수행-클래스)
+
+### 인원 배치 서비스
+
+- [x] 근무표로부터 다음 순번의 근무자를 알아낸 뒤, 배치를 시도한다.
+- [x] 배치가 성공적이지 않다면, 다음 사람으로 배치한다
+- [x] 직전에 근무한 근무자를 알아낸다
+
+## [입력](#입력)
+
+올바르지 않은 입력일 경우, `[ERROR]` 접두사와 함께 에러 메시지를 출력한다
+
+월과 시작 요일의 값이 올바르지 않은 경우, 예외 처리한 뒤 다시 출력한다. 이때, 입력 안내 메시지도 다시 출력한다.
+
+- [x] 비상 근무월 / 시작 요일을 입력받는다
+- [x] 평일, 휴일에 해당하는 비상 근무 순번대로 사원을 입력한다
+
+## [출력](#출력)
+
+- [x] 입력 전, 안내 메시지를 출력한다.
+- [x] 평일이면서 법정공휴일인 경우에만 휴일 표기를 한다.
+- [x] 비상근무표를 출력한다.

docs/how-to-solve.md

@@ -1,5 +1,27 @@
 ### 미션 해결 전략 
 #### 1. 본인이 이해하고 구현한 내용에 기반해 '다른 근무자와 순서를 바꿔야 하는 경우'를 자신만의 예시를 들어 설명하세요. (필수)       
 
+다른 근무자와 순서를 바꿔야 하는 경우는 다음과 같다
+- 바로 **직전에 배치한 근무자**와, **현재 배치하려는 근무자**가 같은 경우
+
+이는 평일-평일, 휴일-휴일에서는 나타나지 않는다. 요구사항에서 평일/휴일 명단을 불러올 때, 중복되는 사람이 존재하지 않았기 때문이다.
+
+따라서 평일-휴일, 휴일-평일에서만 생각해도 충분하고, 직전에 배치한 근무자를 따로 저장해 현재 근무자를 확인하도록 설계했다.
+
+다음 근무자를 배정하는 과정을 간단하게 생각한다면, 근무를 했는지 여부를 나타내는 배열/리스트를 두고 순회하는 방법이 있다. 하지만 이 경우, 근무자가 많아짐에 따라 조회에 오랜 시간이 걸리게 된다.
+
+계산상의 이점을 가져갈 수 없다고 생각했고, 따라서 `Collections`에서 제공하는 `Iterator`를 사용해 보다 효율적으로 탐색했다.
+
+`Iterator`는 선형이기에, 요구사항에서 원하는 원형 탐색을 구현해야 했다. `hasNext` 또는 `hasPrevious`가 거짓인 경우 그 반대쪽을 가리키도록 해서 요구사항을 만족시켰다. 
+
+만약 이틀 연속 근무하는 상황이 발생해 근무를 바꿔야하는 경우, 그 날의 속성(평일/휴일)에만 영향을 미친다. 즉, 평일-휴일에서 휴일에 근무를 두 번 하게 되는 경우, 휴일만 확인하면 된다. 따라서 해당 명단만 확인했고, 다음 근무자를 선정한 뒤 `skipped` 플래그를 통해 다음에 이미 뽑힌 근무자를 지나쳐 가야 하는지 여부를 나타냈다.
 
 #### 2. 요구사항에서 제시한 앞의 날짜부터 순서를 변경하는 방법 외에 다른 방법이 있다면 어떤 방식이 있는지, 이 방법은 기존에 제시된 방식과 비교해 어떤 차이가 있는지 설명하세요. (선택)
+
+근무표를 작성할 때, 가장 중요한 것은 아무래도 공정성일 것이다. 무작위를 통해 근무를 선정한다면 한 사람이 다른 사람들에 비해 더 많이 근무할 수도 있어 이상적이지 않다.
+
+두 번 연속 근무하게 돼 다음 순번과 바꾸는 것은, 다음 사람에 대한 공정성을 해치는 것이기도 하다. 자신이 이 날 근무할 것이라고 예상했지만, 두 번 연속으로 근무하게 될 사람으로 인해 예상치 못하게 근무할 날들이 존재할 수 있기 때문이다.
+
+따라서 타인에 의해 근무가 바뀐 사람의 횟수를 센 뒤, 일정 값이 넘는다면 그 사람과는 바꾸지 않고, 그 다음 사람과 바꾸는 과정을 진행하면 더 공정하게 될 것이다.
+
+이렇게 된다면 최악의 경우 한 사람만 계속해서 근무를 바꿔주는 상황을 최소화할 수 있고, 모두가 공평하다고 생각하는 근무표가 작성될 것이다.

src/main/java/oncall/Application.java

@@ -1,7 +1,20 @@
 package oncall;
 
+import oncall.controller.OnCallController;
+import oncall.io.OnCallConsoleInput;
+import oncall.io.OnCallConsoleOutput;
+import oncall.io.OnCallInput;
+import oncall.io.OnCallOutput;
+import oncall.service.RosterService;
+
 public class Application {
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        OnCallInput input = new OnCallConsoleInput();
+        OnCallOutput output = new OnCallConsoleOutput();
+
+        RosterService rosterService = new RosterService();
+        OnCallController controller = new OnCallController(rosterService, input, output);
+
+        controller.makeRoster();
     }
 }

src/main/java/oncall/config/HolidayConfig.java

@@ -0,0 +1,20 @@
+package oncall.config;
+
+import java.time.MonthDay;
+import java.util.Set;
+
+public class HolidayConfig {
+    public static final Set<MonthDay> holidays = Set.of(
+            MonthDay.of(1, 1),
+            MonthDay.of(3, 1),
+            MonthDay.of(5, 5),
+            MonthDay.of(6, 6),
+            MonthDay.of(8, 15),
+            MonthDay.of(10, 3),
+            MonthDay.of(10, 9),
+            MonthDay.of(12, 25)
+    );
+
+    private HolidayConfig() {
+    }
+}

src/main/java/oncall/controller/ExceptionLoopController.java

@@ -0,0 +1,16 @@
+package oncall.controller;
+
+import java.util.function.Supplier;
+import oncall.exception.OnCallException;
+
+public abstract class ExceptionLoopController {
+    protected <T> T repeatUntilValid(Supplier<T> function) {
+        while (true) {
+            try {
+                return function.get();
+            } catch (OnCallException e) {
+                System.out.println(e.getMessage());
+            }
+        }
+    }
+}

src/main/java/oncall/controller/OnCallController.java

@@ -0,0 +1,55 @@
+package oncall.controller;
+
+import java.util.List;
+import oncall.domain.CombinedRoster;
+import oncall.domain.MonthlyCalendar;
+import oncall.domain.MonthlyRoster;
+import oncall.domain.Roster;
+import oncall.domain.Worker;
+import oncall.io.OnCallInput;
+import oncall.io.OnCallOutput;
+import oncall.service.RosterService;
+
+public class OnCallController extends ExceptionLoopController {
+    private final RosterService rosterService;
+    private final OnCallInput input;
+    private final OnCallOutput output;
+
+    public OnCallController(RosterService rosterService, OnCallInput input, OnCallOutput output) {
+        this.rosterService = rosterService;
+        this.input = input;
+        this.output = output;
+    }
+
+
+    public void makeRoster() {
+        MonthlyCalendar monthlyCalendar = repeatUntilValid(this::makeMonthlyCalendar);
+
+        CombinedRoster combinedRoster = repeatUntilValid(this::makeCombinedRoster);
+        MonthlyRoster monthlyRoster = rosterService.makeMonthlyRoster(monthlyCalendar, combinedRoster);
+        output.printRoster(monthlyRoster);
+    }
+
+    private MonthlyCalendar makeMonthlyCalendar() {
+        output.printAskingMonthAndWeekDay();
+        return input.getMonthAndDayOfWeek();
+    }
+
+    private CombinedRoster makeCombinedRoster() {
+        Roster weekDayRoster = makeWeekDayRoster();
+        Roster holidayRoster = makeHolidayRoster();
+        return new CombinedRoster(weekDayRoster, holidayRoster);
+    }
+
+    private Roster makeWeekDayRoster() {
+        output.printAskingWeekDayWorkers();
+        List<Worker> weekdayWorkers = input.getWorkers();
+        return new Roster(weekdayWorkers);
+    }
+
+    private Roster makeHolidayRoster() {
+        output.printAskingHolidayWorkers();
+        List<Worker> holidayWorkers = input.getWorkers();
+        return new Roster(holidayWorkers);
+    }
+}

src/main/java/oncall/domain/CombinedRoster.java

@@ -0,0 +1,44 @@
+package oncall.domain;
+
+import oncall.exception.IllegalCombinedRosterException;
+
+public class CombinedRoster {
+    private final Roster weekdayRoster;
+    private final Roster holidayRoster;
+
+    public CombinedRoster(Roster weekdayRoster, Roster holidayRoster) {
+        validateIdenticalWorkers(weekdayRoster, holidayRoster);
+        this.weekdayRoster = weekdayRoster;
+        this.holidayRoster = holidayRoster;
+    }
+
+
+    public Worker getWorker(RosterDay rosterDay, Worker previousWorker) {
+        if (rosterDay.isHoliday()) {
+            return getHolidayWorker(previousWorker);
+        }
+        return getWeekdayWorker(previousWorker);
+    }
+
+    private void validateIdenticalWorkers(Roster weekdayRoster, Roster holidayRoster) {
+        if (!weekdayRoster.isSameAs(holidayRoster)) {
+            throw new IllegalCombinedRosterException();
+        }
+    }
+
+    private Worker getWeekdayWorker(Worker previousWorker) {
+        Worker worker = weekdayRoster.checkNextWorker();
+        if (worker.equals(previousWorker)) {
+            return weekdayRoster.getAfterNextWorker();
+        }
+        return weekdayRoster.getNextWorker();
+    }
+
+    private Worker getHolidayWorker(Worker previousWorker) {
+        Worker worker = holidayRoster.checkNextWorker();
+        if (worker.equals(previousWorker)) {
+            return holidayRoster.getAfterNextWorker();
+        }
+        return holidayRoster.getNextWorker();
+    }
+}

src/main/java/oncall/domain/DailyRoster.java

@@ -0,0 +1,16 @@
+package oncall.domain;
+
+public class DailyRoster {
+    private final RosterDay rosterDay;
+    private final Worker worker;
+
+    public DailyRoster(RosterDay rosterDay, Worker worker) {
+        this.rosterDay = rosterDay;
+        this.worker = worker;
+    }
+
+    @Override
+    public String toString() {
+        return rosterDay.toString() + " " + worker.name();
+    }
+}

src/main/java/oncall/domain/MonthlyCalendar.java

@@ -0,0 +1,23 @@
+package oncall.domain;
+
+import java.time.DayOfWeek;
+import java.time.Month;
+import java.time.MonthDay;
+
+public class MonthlyCalendar {
+    private final Month month;
+    private final DayOfWeek startDayOfWeek;
+
+    public MonthlyCalendar(Month month, DayOfWeek startDayOfWeek) {
+        this.month = month;
+        this.startDayOfWeek = startDayOfWeek;
+    }
+
+    public RosterDay get(int day) {
+        return new RosterDay(MonthDay.of(month, day), startDayOfWeek.plus(day - 1L));
+    }
+
+    public int getLastDay() {
+        return month.minLength();
+    }
+}

src/main/java/oncall/domain/MonthlyRoster.java

@@ -0,0 +1,22 @@
+package oncall.domain;
+
+import java.util.List;
+import java.util.StringJoiner;
+
+public class MonthlyRoster {
+    private final List<DailyRoster> dailyRosters;
+
+    public MonthlyRoster(List<DailyRoster> dailyRosters) {
+        this.dailyRosters = dailyRosters;
+    }
+
+    @Override
+    public String toString() {
+        StringJoiner stringJoiner = new StringJoiner(System.lineSeparator());
+        dailyRosters.stream()
+                .map(DailyRoster::toString)
+                .forEach(stringJoiner::add);
+
+        return stringJoiner.toString();
+    }
+}