[🚀 사이클2 - 미션 (기물 확장 + DB 적용)] 이프 미션 제출합니다.

README.md

@@ -1,4 +1,12 @@
-# 1단계 - 보드 초기화
+# 실행 방법
+
+`docker-compose up -d`로 db 세팅 후 프로젝트 실행
+
+---
+
+# Cycle 1
+
+## 1단계 - 보드 초기화
 
 ```
 한나라의 상차림을 선택해주세요.
@@ -35,7 +43,7 @@
 　＋－－－－－－－－－－－－－－－－－－－＋
 ```
 
-## 기능 정리
+### 기능 정리
 
 - 상차림 순서 관리
     - 한나라부터 상차림 입력을 받는다.
@@ -56,7 +64,7 @@
 - 나라 정보
     - 한, 초
 
-## 구현 순서
+### 구현 순서
 
 * 초나라/한나라 상차림 입력
     * 나라 별 유효한 상차림을 입력받는다.
@@ -70,11 +78,11 @@
         * 장기판 위치 범위를 초과하면 예외가 발생해야한다.
     * 장기판이 필요하다.
 
-# 2단계 - 기물 이동
+## 2단계 - 기물 이동
 
 - 2단계에서는 기물 이동 구현이 목적이니까 종료는 `Ctrl+C`로 강제 종료한다.
 
-## 잘못된 기물 선택 시나리오
+### 잘못된 기물 선택 시나리오
 
 1. 다른 나라의 기물을 선택했을 때
     1. 예외: 다른나라의 기물 선택
@@ -83,7 +91,7 @@
     1. 예외: 기물이 없는 곳을 선택
     2. `[ERROR] 현재 위치에 존재하는 기물이 없습니다.`
 
-## 기물 이동 규칙
+### 기물 이동 규칙
 
 - 궁성 영역 - 고려하지 않는다. (사이클 2)
 - 기물 이동 규칙 공통
@@ -104,7 +112,7 @@
     - 한 칸이라서 경로에 기물이 있을 리가 없다.
 - `사, 장`: 궁성 영역이므로 구현하지 않는다.
 
-## 입출력 예시
+### 입출력 예시
 
 ```
 1단계 ...
@@ -129,7 +137,6 @@
 [초나라] 기물 卒의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
 위치: 6,7
 
-
 　　　０　１　２　３　４　５　６　７　８
 　＋－－－－－－－－－－－－－－－－－－－＋
 ０｜　車　馬　象　士　＊　士　象　馬　車　｜
@@ -149,11 +156,9 @@
 
 [ERROR] 현재 위치에 존재하는 기물이 없습니다.
 
-
 [한나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
 기물: 3,0
 
-
 [한나라] 기물 兵의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
 위치: 3,1
 
@@ -172,7 +177,7 @@
 　＋－－－－－－－－－－－－－－－－－－－＋
 ```
 
-## 구현 순서
+### 구현 순서
 
 1. 기물 이동 기능 추가
     * 나라 별 입력
@@ -183,4 +188,256 @@
         * 기물의 이동할 위치를 입력 받는다.
             * 잘못된 범위라면 예외를 발생한다.
             * 해당 위치에 아군의 기물이 존재한다면 예외가 발생한다.
-        * 기물 별로 이동할 수 없는 목적지라면 예외가 발생한다.
+        * 기물 별로 이동할 수 없는 목적지라면 예외가 발생한다.
+
+---
+
+# Cycle2
+
+## 1단계 - 기물의 확장
+
+1. 궁성 영역을 정의한다.
+    * 한나라 궁성: (0,3) ~ (2,5) 내 9개 위치
+    * 초나라 궁성: (7,3) ~ (9,5) 내 9개 위치
+    * 궁성 내 대각선 이동 가능 교차점을 정의한다.
+        * 한나라: (0,3), (0,5), (1,4), (2,3), (2,5)
+        * 초나라: (7,3), (7,5), (8,4), (9,3), (9,5)
+2. 장(將/楚), 사(士)의 이동을 구현한다.
+    * 출발 지점이 궁성 영역이 아니라면 예외가 발생한다.
+    * 도착 지점이 궁성 영역이 아니라면 예외가 발생한다.
+    * 직선(상하좌우) 한 칸 이동이 가능하다.
+    * 대각선 한 칸 이동이 가능하다.
+        * 대각선 이동은 궁성 내 대각선 교차점에서만 출발할 수 있다.
+3. 차(車)의 궁성 내 이동을 추가 구현한다.
+    * 궁성 내에서 대각선 이동이 가능하다.
+    * 대각선 이동은 궁성 내 대각선 교차점에서만 출발할 수 있다.
+        * 대각선 이동 경로 상에 기물이 있으면 예외가 발생한다.
+4. 포(包)의 궁성 내 이동을 추가 구현한다.
+    * 궁성 내에서 대각선 이동이 가능하다.
+    * 대각선 이동은 궁성 내 대각선 교차점에서만 출발할 수 있다.
+        * 대각선 이동 경로 상에 정확히 하나의 기물을 뛰어넘어야 한다.
+        * 포는 뛰어넘을 수 없다.
+5. 졸(卒)/병(兵)의 궁성 내 이동을 추가 구현한다.
+    * 궁성 내에서 대각선 한 칸 이동이 가능하다.
+    * 대각선 이동은 궁성 내 대각선 교차점에서만 출발할 수 있다.
+        * 전진 방향 대각선만 이동 가능하다.
+6. 게임 종료
+    * 왕(장)이 잡히면 게임이 종료된다.
+        * 한나라 왕이 잡히면 초나라가 승리한다.
+        * 초나라 왕이 잡히면 한나라가 승리한다.
+    * 게임 종료 시 승리한 팀을 출력한다.
+7. 점수 계산
+    * 왕이 잡히지 않은 경우 점수로 승패를 결정한다. (빅장)
+        * 점수가 높은 팀이 승리한다.
+        * 1.5점 가산으로 인해 무승부는 발생하지 않는다.
+            * 초나라는 후수이므로 1.5점의 추가 점수를 받는다.
+
+### 예시 출력 1) 빅장
+
+```
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　卒　＊　＊　卒　卒　＊　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[초나라] 빅장입니다! 종료하시겠습니까? (Y, N)
+N
+
+[초나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+기물: 6,3
+
+[초나라] 기물 卒의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
+위치: 5,3
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　馬　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　卒　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　＊　＊　卒　卒　＊　｜
+７｜　＊　包　＊　＊　＊　＊　＊　包　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　馬　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[한나라] 빅장입니다! 종료하시겠습니까? (Y, N)
+Y
+
+한나라 승
+초나라: 72점
+한나라: 73.5점
+```
+
+### 예시 출력 2) 왕 죽음
+
+```
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　＊　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　馬　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　包　＊　馬　＊　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　＊　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[초나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+기물: 7,4
+
+[초나라] 기물 包의 다음 위치를 선택해주세요. (쉼표 기준으로 분리)
+위치: 1,4
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　＊　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　包　＊　＊　＊　＊　｜
+２｜　＊　包　馬　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　＊　＊　馬　＊　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　＊　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+초나라 승
+```
+
+## 2단계 - DB 적용
+
+1. 이전에 하던 게임을 다시 시작할 수 있어야 한다.
+    * 장기를 저장하고 그대로 꺼내온다.
+2. 장기 게임방을 만들고 장기 게임방에 입장할 수 있는 기능을 추가한다. (선택)
+    * 추후 작성
+
+### 잘못된 게임 메뉴 선택
+
+```text
+> 장기 게임 메뉴
+
+1. 게임 이어서 진행하기
+2. 새로 시작하기
+3. 종료하기
+
+메뉴를 선택해주세요:
+4
+
+[ERROR] 잘못된 입력입니다.
+```
+
+### 종료된 게임 선택
+
+```text
+
+> 장기 게임 메뉴
+
+1. 게임 이어서 진행하기
+2. 새로 시작하기
+3. 종료하기
+
+메뉴를 선택해주세요:
+1
+
+> 이어서 진행할 게임을 선택해주세요.
+1번 게임: 종료 상태
+2번 게임: 진행 상태
+
+번호를 입력해주세요:
+1
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　＊　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　包　＊　＊　＊　＊　｜
+２｜　＊　包　馬　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　＊　＊　馬　＊　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　＊　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+초나라 승
+```
+
+### 존재하지 않는 게임 선택
+
+```text
+
+> 장기 게임 메뉴
+
+1. 게임 이어서 진행하기
+2. 새로 시작하기
+3. 종료하기
+
+메뉴를 선택해주세요:
+1
+
+> 이어서 진행할 게임을 선택해주세요.
+1번 게임: 종료 상태
+2번 게임: 진행 상태
+
+번호를 입력해주세요:
+3
+
+[ERROR] 1번 장기 게임이 존재하지 않습니다.
+```
+
+### 이전 게임 다시 시작
+
+```text
+
+> 장기 게임 메뉴
+
+1. 게임 이어서 진행하기
+2. 새로 시작하기
+3. 종료하기
+
+메뉴를 선택해주세요:
+1
+
+> 이어서 진행할 게임을 선택해주세요.
+1번 게임: 종료 상태
+2번 게임: 진행 상태
+
+번호를 입력해주세요:
+2
+
+　　　０　１　２　３　４　５　６　７　８
+　＋－－－－－－－－－－－－－－－－－－－＋
+０｜　車　＊　象　士　＊　士　象　馬　車　｜
+１｜　＊　＊　＊　＊　漢　＊　＊　＊　＊　｜
+２｜　＊　包　馬　＊　＊　＊　＊　包　＊　｜
+３｜　兵　＊　兵　兵　＊　＊　兵　＊　兵　｜
+４｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+５｜　＊　＊　＊　＊　＊　＊　＊　＊　＊　｜
+６｜　卒　＊　卒　＊　卒　＊　卒　＊　卒　｜
+７｜　＊　包　＊　＊　包　＊　馬　＊　＊　｜
+８｜　＊　＊　＊　＊　楚　＊　＊　＊　＊　｜
+９｜　車　馬　象　士　＊　士　象　＊　車　｜
+　＋－－－－－－－－－－－－－－－－－－－＋
+
+[초나라] 이동할 기물을 선택해주세요. (쉼표 기준으로 분리)
+
+...
+
+```

build.gradle

@@ -9,6 +9,8 @@ repositories {
 }
 
 dependencies {
+    implementation 'com.mysql:mysql-connector-j:8.4.0'
+
     testImplementation platform('org.junit:junit-bom:5.11.4')
     testImplementation platform('org.assertj:assertj-bom:3.27.3')
     testImplementation('org.junit.jupiter:junit-jupiter')

docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  db:
+    image: mysql:8.4
+    container_name: janggi-db
+    restart: always
+    environment:
+      MYSQL_DATABASE: janggi_db
+      MYSQL_USER: janggi
+      MYSQL_PASSWORD: janggi1234
+      MYSQL_ROOT_PASSWORD: root_password
+    ports:
+      - "3309:3306"
+    volumes:
+      - ./init:/docker-entrypoint-initdb.d

init/v1_ddl.sql

@@ -0,0 +1,18 @@
+CREATE TABLE IF NOT EXISTS janggi_game (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    status VARCHAR(20) NOT NULL COMMENT '게임 상태',
+    turn VARCHAR(10) NOT NULL COMMENT '현재 게임 턴',
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS piece (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    game_id BIGINT NOT NULL,
+    `row` INT NOT NULL COMMENT '행 좌표 (0~9)',
+    `col` INT NOT NULL COMMENT '열 좌표 (0~8)',
+    `type` VARCHAR(20) NOT NULL COMMENT '기물 종류)',
+    `team` VARCHAR(20) NOT NULL COMMENT '진영',
+    FOREIGN KEY (game_id) REFERENCES janggi_game(id) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE INDEX idx_game_id ON piece(game_id);