[🚀 사이클1 - 미션 (보드 초기화 + 기물 이동)] 제이콥 미션 제출합니다.

README.md

@@ -1,3 +1,298 @@
-# java-janggi
+# [장기] 사이클1 - 미션 (보드 초기화 + 기물 이동)
 
-장기 미션 저장소
+## 목표
+
+단순히 코드를 작성하는 것이 아니라, **무엇을 개발해야 하는지 먼저 정리하고** 개발을 진행하는 것이 핵심이다.
+
+- [x] 1.1단계를 시작하기 전에 **어떤 기능을 구현해야 하는지 정리**한다.
+- [x] 1.1단계에서 정리한 내용을 README.md에 기능 목록으로 작성한다.
+- [x] 1.2단계를 시작하기 전에 **어떤 기능을 구현해야 하는지 정리**한다.
+- [x] 1.2단계에서 정리한 내용을 README.md에 기능 목록으로 작성한다.
+- [x] 개발 과정에서 **"나는 왜 이렇게 구현할까?"** 라는 고민을 기록한다.
+
+---
+
+## 기능 요구 사항
+
+### 1.1단계 - 보드 초기화
+
+- 게임 시작 시 장기판과 전체 기물을 올바른 위치에 초기화한다.
+- 1.1단계에서는 기물의 이동은 구현하지 않는다.
+
+### 1.2단계 - 기물 이동
+
+- 각 기물의 이동 규칙을 구현한다.
+- 기물의 이동 규칙은 직접 요구사항을 분석하여 정의한다.
+- **궁성(宮城) 영역은 구현하지 않는다.** (사이클2에서 다룬다)
+
+---
+
+## 기능 목록 (테스트 명세)
+
+### 1.1단계: 보드 및 기본 도메인 초기화
+
+#### 위치 (Position)
+- [x] x 좌표가 0 미만이거나 8 초과이면 예외가 발생한다
+- [x] y 좌표가 0 미만이거나 9 초과이면 예외가 발생한다
+- [x] 올바른 x, y 좌표가 주어지면 객체가 정상적으로 생성된다
+
+#### 진영 (Side)
+- [x] 진영은 초와 한만 가진다
+
+#### 플레이어 (Player)
+- [x] 턴 상태를 토글하면 현재 턴 여부가 반전된다
+- [x] 플레이어는 상대방의 기물을 선택하면 예외가 발생한다
+
+#### 플레이어들 (Players)
+- [x] 초기 플레이어 생성 시 두 플레이어의 이름이 같으면 예외가 발생한다
+
+#### 기물 공통 (Piece)
+- [x] 주어진 진영과 자신의 진영이 같은지 올바르게 판별한다
+
+#### 장기판 초기화 (BoardFactory / Board)
+- [x] 선택한 포메이션에 맞게 32개의 기물이 초기 위치에 정확히 배치된다
+- [x] 양 진영의 궁이 지정된 궁성 위치에 정상적으로 배치된다
+
+### 1.2단계: 기물 이동 및 게임 상태
+
+#### 궁 (General)
+- [x] 궁은 상 하 좌 우 1칸 이동할 수 있다 (OneStepStrategy)
+
+#### 사 (Guard)
+- [x] 사는 상 하 좌 우 1칸 이동할 수 있다 (OneStepStrategy)
+
+#### 졸 (Soldier)
+- [x] 초나라 졸은 상 좌 우 1칸 이동할 수 있다 (OneStepStrategy)
+- [x] 한나라 졸은 하 좌 우 1칸 이동할 수 있다 (OneStepStrategy)
+
+#### 마 (Horse)
+- [x] 마는 직선 1칸 이동 후 대각선 1칸 방향으로 이동할 수 있다 (SequenceStrategy)
+- [x] 마는 직선 1칸 경로에 장애물 기물이 존재하면 해당 방향으로 이동할 수 없다
+
+#### 상 (Elephant)
+- [x] 상은 직선 1칸 이동 후 대각선 2칸 방향으로 이동할 수 있다 (SequenceStrategy)
+- [x] 상은 직선 1칸 또는 대각선 1칸 경로 중 하나라도 장애물 기물이 존재하면 이동할 수 없다
+
+#### 차 (Chariot)
+- [x] 차는 상 하 좌 우 방향으로 장애물을 만날 때까지 연속해서 이동할 수 있다 (ContinuousStrategy)
+- [x] 차는 이동 경로 중 아군 기물을 만나면 그 직전 위치까지만 이동할 수 있다
+- [x] 차는 이동 경로 중 적군 기물을 만나면 해당 위치까지 이동하여 잡을 수 있다
+
+#### 포 (Cannon)
+- [x] 포는 상 하 좌 우 방향으로 기물 하나를 뛰어넘어 빈칸으로 이동할 수 있다 
+- [x] 포는 이동 경로에서 포 기물을 뛰어넘을 수 없다
+- [x] 포는 기물을 뛰어넘은 후 적군 기물을 만나면 해당 위치까지 이동하여 잡을 수 있다 (ContinuousStrategy)
+- [x] 포는 뛰어넘은 후 만난 적군 기물이 포일 경우 잡을 수 없다
+
+#### 장기판 이동 (Board)
+- [x] 목적지에 적군 기물이 있으면 보드에서 해당 기물을 제거하고 이동한다
+- [x] 목적지에 아군 기물이 있으면 이동할 수 없다
+- [x] 기물이 존재하지 않는 빈 좌표를 출발지로 입력하면 예외가 발생한다
+
+#### 게임 상태 및 흐름 (Game)
+- [x] 기물 이동이 완료되면 턴이 상대방 진영으로 변경된다
+- [x] 이동할 수 있는 목적지가 전혀 없는 기물을 선택하면 예외가 발생한다
+- [x] 선택한 기물이 이동할 수 없는 위치를 목적지로 입력하면 예외가 발생한다
+- [x] 보드에 궁이 하나만 남게 되면 게임은 종료 상태가 된다
+
+### 1.3단계: 사용자 입력 및 파서 검증
+
+#### 플레이어 이름 입력
+- [x] 이름이 2글자 미만이거나 5글자를 초과하면 예외가 발생한다
+- [x] 이름에 빈 값이나 공백만 입력되면 예외가 발생한다
+
+#### 포메이션(마, 상) 옵션 입력
+- [x] 포메이션 입력이 1, 2, 3, 4 일 때 정상 동작한다
+- [x] 포메이션 입력이 1, 2, 3, 4 중 하나가 아니면 예외가 발생한다
+
+#### 위치 입력
+- [x] 올바른 좌표 형식이 입력되는 경우 정상 동작한다
+- [x] 위치 입력 포맷이 `(x, y)` 형태가 아니면 예외가 발생한다
+- [x] 위치 입력 포맷 내의 좌표에 숫자가 아닌 값이 포함되면 예외가 발생한다
+
+## 구조 및 설계
+
+- [x] 이동 방향(Direction) 분리: 상, 하, 좌, 우 등 x/y 증감값을 갖는 Enum 구현
+- [x] 이동 전략(Strategy) 분리: `OneStepStrategy`, `ContinuousStrategy`, `SequenceStrategy` 구현 및 각 기물에 주입
+- [x] 플라이웨이트 팩토리(PieceFactory): 위치 상태가 없는 불변 기물 객체를 싱글톤/캐싱하여 반환
+- [x] 보드 캡슐화(BoardReader): 기물이 보드의 맵 자료구조에 직접 접근하지 못하도록 읽기 전용 인터페이스 도입
+- [x] 불변 맵 복사: 보드 이동 시 `Map.copyOf()`를 사용하여 불변 맵 반환
+
+---
+
+## 입출력예시
+1. 초나라 플레이어의 이름을 입력받는다.
+2. 한나라 플레이어 이름을 입력받는다.
+3. 초나라 플레이어의 기물 배치를 입력받는다.
+
+    ```
+    기물 배치를 선택하세요. 
+    1. 상마상마
+    2. 마상마상
+    3. 상마마상
+    4. 마상상마
+    ```
+
+4. 한나라 플레이어의 기물 배치를 입력받는다.
+
+    ```
+    기물 배치를 선택하세요. 
+    1. 상마상마
+    2. 마상마상
+    3. 상마마상
+    4. 마상상마
+    ```
+
+5. 초나라 플레이어부터 한 턴씩 진행
+
+    1. 보드판 출력
+
+    2. 플레이어가 선택할 수 있는 기물의 위치를 입력받는다.
+
+        ```
+        (보드판 출력)
+        이동 시킬 기물의 위치를 입력하세요. ex) (0, 3)
+        ```
+
+    3. 선택한 기물의 목적지를 입력받는다.
+
+        ```
+        선택한 기물이 이동할 수 있는 위치입니다. 이동할 위치를 입력하세요. ex) (0, 3)
+        (x, y), (x, y), ...
+        ```
+
+    4. 왕이 잡히면 게임 종료
+        ```
+        제이콥(이/가) 승리했습니다.
+        ```
+
+---
+
+## 프로그래밍 요구 사항
+
+- [x] 자바 코드 컨벤션을 지키면서 프로그래밍한다.
+    - [x] 기본적으로[Java Style Guide](https://github.com/woowacourse/woowacourse-docs/tree/master/styleguide/java)을 원칙으로 한다.
+- [x] indent(인덴트, 들여쓰기) depth를 2를 넘지 않도록 구현한다. 1까지만 허용한다.
+    - [x] 예를 들어 while문 안에 if문이 있으면 들여쓰기는 2이다.
+    - [x] 힌트: indent(인덴트, 들여쓰기) depth를 줄이는 좋은 방법은 함수(또는 메서드)를 분리하면 된다.
+- [x] 3항 연산자를 쓰지 않는다.
+- [x] else 예약어를 쓰지 않는다.
+    - [x] else 예약어를 쓰지 말라고 하니 switch/case로 구현하는 경우가 있는데 switch/case도 허용하지 않는다.
+    - [x] 힌트: if문에서 값을 반환하는 방식으로 구현하면 else 예약어를 사용하지 않아도 된다.
+- [ ] 모든 기능을 TDD로 구현해 단위 테스트가 존재해야 한다. 단, UI(System.out, System.in) 로직은 제외
+    - [ ] 핵심 로직을 구현하는 코드와 UI를 담당하는 로직을 구분한다.
+    - [x] UI 로직을 view.InputView, ResultView와 같은 클래스를 추가해 분리한다.
+- [x] 함수(또는 메서드)의 길이가 10라인을 넘어가지 않도록 구현한다.
+    - [x] 함수(또는 메소드)가 한 가지 일만 하도록 최대한 작게 만들어라.
+- [x] 배열 대신 컬렉션을 사용한다.
+- [ ] 모든 원시 값과 문자열을 포장한다.
+- [x] 줄여 쓰지 않는다(축약 금지).
+- [x] 일급 컬렉션을 쓴다.
+- [x] 모든 엔티티를 작게 유지한다.
+- [x] 3개 이상의 인스턴스 변수를 가진 클래스를 쓰지 않는다.
+
+### 추가된 요구 사항
+
+- [x] 도메인의 의존성을 최소한으로 구현한다.
+- [ ] 한 줄에 점을 하나만 찍는다.
+- [ ] 게터/세터/프로퍼티를 쓰지 않는다.
+- [ ] 모든 객체지향 생활 체조 원칙을 잘 지키며 구현한다.
+- [ ] [프로그래밍 체크리스트](https://github.com/woowacourse/woowacourse-docs/blob/master/cleancode/pr_checklist.md)의 원칙을 지키면서 프로그래밍한다.
+
+---
+
+## 팀 규칙
+
+> [!abstract] ### **1. 상태 위치 규칙**
+>
+> (If-Then) 만약 기물의 위치가 이동, 잡힘, 배치 변경처럼 게임판 전체 상태 변화와 함께 바뀐다면
+>
+> → 위치 정보는 보드가 관리하고, 기물은 자신의 위치를 직접 가지지 않는다
+>
+> (기준) 상태 소유 기준: 변경의 책임이 있는 객체가 그 상태를 소유한다
+>
+> (금지) 이번 미션에서 보드와 기물이 동시에 위치 상태를 가지지 않는다
+>
+> ---
+>
+> ### **2. 불변 객체 기준**
+>
+> (If-Then) 만약 기물이 가지는 정보가 종류, 소속 팀, 이동 규칙처럼 게임 도중 바뀌지 않는 값이라면
+>
+> → 기물 객체는 불변으로 만든다
+>
+> (기준) 불변성 판단 기준: 게임 도중 변하지 않는 정보는 객체 내부에서 변경 불가능해야 한다
+>
+> (금지) 이번 미션에서 기물의 종류, 팀, 이동 규칙을 생성 후 변경하지 않는다
+>
+> ---
+>
+> ### **3. 캡슐화 기준**
+>
+> (If-Then) 만약 어떤 상태를 외부에서 직접 수정 시 규칙 위반이나 정합성 문제가 생긴다면
+>
+> → 그 상태는 내부에 캡슐화하고, 책임 있는 객체만 변경할 수 있게 한다
+>
+> (If-Then) 만약 보드의 내부 상태가 외부 로직에 그대로 노출되면
+>
+> → 보드의 상태는 직접 수정 가능한 형태로 공개하지 않고, 필요한 동작만 메서드로 제공한다
+>
+> (기준) 캡슐화 기준: 정합성을 깨뜨릴 수 있는 내부 표현과 수정 권한은 숨긴다
+>
+> (금지) 이번 미션에서 보드의 내부 상태를 외부에서 직접 수정하지 않는다
+>
+> ---
+>
+> ### **4. null 사용 기준**
+>
+> (If-Then) 만약 빈 칸도 보드 위의 의미 있는 상태라면
+>
+> → 빈 칸은 null 대신 객체 또는 존재 여부가 드러나는 방식으로 표현한다
+>
+> (If-Then) 만약 빈 칸 여부를 자주 검사해야 한다면
+>
+> → null 검사에 의존하기보다, 빈 상태를 명시적으로 표현하는 구조를 우선한다
+>
+> (기준) null 사용 기준: 없음도 의미 있는 상태라면 명시적으로 표현한다
+>
+> (금지) 이번 미션에서 빈 칸을 단순 null 검사에만 의존하여 처리하지 않는다
+>
+> ---
+>
+> ### **5. 조건문 대체 기준**
+>
+> (If-Then) 만약 조건문이 객체의 종류에 따라 동작을 나누기 위해 사용된다면
+>
+> → 조건문 대신 다형성을 우선 고려하고, 각 객체가 자신의 규칙을 직접 구현한다
+>
+> (If-Then) 만약 조건문이 보드 범위 확인, 장애물 확인, 같은 팀 여부 확인처럼 객체 종류와 무관한 공통 검증이라면
+>
+> → 이런 조건문은 공통 로직으로 유지한다
+>
+> (기준) 다형성 적용 기준: 같은 질문에 객체마다 다른 답을 해야 하면 다형성 후보로 본다
+>
+> (금지) 이번 미션에서 기물 타입을 문자열, enum, switch/if로 반복 분기하여 이동 규칙을 처리하지 않는다
+>
+> ---
+>
+> ### **6. 역할/인터페이스 설계 기준**
+>
+> (If-Then) 만약 여러 객체가 같은 행위를 해야 하지만 구현 방식은 서로 다르다면
+>
+> → 공통 인터페이스를 정의해 무엇을 할 수 있는가를 통일한다.
+>
+> (기준) 인터페이스 설계 기준: 호출 방식은 통일하고, 구현 방식은 각 객체에 위임한다.
+>
+> (금지) 이번 미션에서 호출하는 쪽이 기물 종류를 먼저 판별한 뒤 각 규칙을 직접 실행하지 않는다.
+>
+> ---
+>
+> ### **7. 새 타입 추가 시 변경 범위 제한 규칙**
+>
+> (If-Then) 만약 새 기물이 추가될 때 기존 이동 로직을 여러 곳 수정해야 한다면
+>
+> → 기물별 책임 분리가 부족한 것으로 보고 구조를 꼭 필히 다시 점검한다.
+>
+> (기준) 확장성 판단 기준: 새로운 기물 추가나 규칙 변경 시 기존 코드 수정 범위가 작아야 한다.
+>
+> (금지) 이번 미션에서 새 기물 추가를 위해 기존 분기문을 계속 늘리는 방식으로 확장하지 않는다

src/main/java/Application.java

@@ -0,0 +1,14 @@
+import application.GameManager;
+import java.util.Scanner;
+import view.InputView;
+import view.OutputView;
+
+public class Application {
+    public static void main(String[] args) {
+        GameManager gameManager = new GameManager(
+                new InputView(new Scanner(System.in)),
+                new OutputView()
+        );
+        gameManager.play();
+    }
+}