[🚀 사이클2 - 미션 (기물 확장 + DB 적용)] 루드비코 미션 제출합니다. #325

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Choi-JJunho merged 73 commits into woowacourse:hyoyoonnam from HyoYoonNam:cycle2

Apr 13, 2026

.gitignore

-Original file line number
+Diff line change
@@ Expand Up / @@ -33,3 +33,9 @@ out/ @@
     ### Mac ###
     **/.DS_Store
+    ### DB - SQLite ###
+    /src/main/resources/db/*
+    !src/main/resources/db/.gitkeep
+    /src/test/resources/db/
+    :memory:?cache=shared

README.md

-Original file line number
+Diff line change
@@ Expand Up / @@ -3,6 +3,9 @@ @@
     장기 미션 저장소
     ## 실행 예시
+    ### 일반적인 게임 진행 흐름
     ```text
     장기 게임을 시작합니다.
@@ Expand Down Expand Up / @@ -44,24 +47,92 @@ @@
 ,5
     ...
+    --- 게임이 종료되었습니다 ---
+    점수) CHO 10점, HAN 8.5점
+    CHO의 승리!
+    ```
+    ### 시작 메뉴
+    ```text
+    안녕하세요. 루드비코의 장기 마을입니다!
+    아래 메뉴 중 하나를 선택해 주세요.
+. 새 게임
+. 이전 게임 조회(이어하기/결과 확인)
+    ```
+    #### 이전 게임 조회
+    ```markdown
+    ------------- 저장된 게임 목록 -------------
+    [ID: 1] 시작: 2026-04-07 12:53 / 차례: CHO
+    [ID: 2] 시작: 2026-04-07 15:36 / 차례: HAN
+    ----------------------------------------
+    불러올 게임의 ID를 입력하세요: 1
+    장기 게임을 시작합니다.
+    ...
+    ```
+    ### 저장 흐름
+    #### 사용자 입력으로 인한 종료
+    ```text
+    장기 게임을 시작합니다.
+    ...
+    초(파란색) 차례입니다. 이동할 기물의 좌표를 입력하세요 ('exit'를 입력하면 종료):
+    exit
+    --- 게임을 종료합니다 ---
+    ```
+    #### 게임 승패 판정으로 인한 종료
+    ```text
+    ...
+    --- 게임이 종료되었습니다 ---
+    점수) CHO 10점, HAN 8.5점
+    CHO의 승리!
+    ```
+    #### 내/외부 문제로 인한 강제 종료
+    ```text
+    (내/외부 문제로 인한 강제 종료를 가정)
     ```
     ## 구현할 기능 목록
     ### 입력 기능
-    - [x] 제대로 된 입력값이 아니라면, 재입력을 요청한다.
-      - [x] 상차림을 입력받는다.
-      - [x] 이동할 기물의 위치를 입력받는다.
-      - [x] 기물을 이동시킬 위치를 입력받는다.
+    특정 입력 기능과 연관된 게임의 종료 등 시스템 명령은 🛠️ 이모지를 붙여 구분한다.
+    예를 들어, 게임 종료(exit) 시스템 명령은 이동할 기물의 위치를 입력받을 때만 전달할 수 있다.
+    - [x] 공통: 제대로 된 입력값이 아니라면, 재입력을 요청한다.
+    - [x] 상차림을 입력받는다.
+    - [x] 이동할 기물의 위치를 입력받는다.
+      - [x] `1,5` 형식으로 입력받는다.
+      - [x] 🛠️ `exit`를 입력하면 게임을 종료한다.
+    - [x] 기물을 이동시킬 위치를 입력받는다.
+      - 이동할 기물을 선택하면 무를 수 없다. 즉, 게임 종료는 이동할 기물의 위치를 선택하기 전에만 명령할 수 있다.
     ### 출력 기능
     - [x] 게임 시작을 알린다.
     - [x] 상차림 초기화 후 장기판의 상황을 출력한다.
     - [x] 선택한 기물이 이동할 수 있는 지점을 모두 표시한다.
     - [x] 기물 이동 후 장기판의 상황을 출력한다.
-    - [x] 게임이 종료와 함께 승리 진영을 출력한다.
+    - [x] 게임 종료시
+      - [x] 승리 진영을 출력한다.
+      - [x] 승리 원인을 출력한다.
+      - [x] 진영별 점수는 점수 차이로 인한 승리일 때만 출력한다.
     ### 도메인 기능
@@ Expand All / @@ -71,19 +142,59 @@ @@
     - [x] 이동할 수 없는 지점으로 움직이려하면 예외를 던진다.
     - [x] 각 진영은 교대로 기물을 이동한다.
     - [x] 왕이 잡히면 게임이 끝난다.
+    - [x] `궁`과 `사`는 궁성의 밖으로 이동할 수 없다.
+    - [x] `상`과 `마`를 제외한 기물은 (본인의 행마법을 준수하는 것을 전제로) 궁성의 대각선을 타고 이동할 수 있다.
+      - 예를 들어, `병/졸`은 대각선 방향으로 전진은 가능하지만 후진은 불가하다. `포`는 이동할 대각선 방향에 screen이 존재해야 한다. (...)
+    - [x] 점수 계산
+      - [x] 게임이 종료되면, 남아 있는 기물에 대한 점수를 계산한다. 각 기물의 점수는 [장기 규칙](https://arc.net/l/quote/isyrogth)을 참고한다.
+      - [x] 한(HAN, 漢) 진영은 1.5점의 보너스 점수를 받는다.
+    - [x] 게임 종료
+      - [x] 한 쪽 진영의 왕이 잡히면 게임을 종료한다.
+      - [x] 양 쪽 진영의 왕이 모두 잡히지 않았어도, 양 쪽 모두 기물 점수의 합이 30점 미만이라면 게임을 종료한다. (진영 보너스 점수는 합계에서 제외)
+    - [x] 승패 판단
+      - [x] 왕이 잡힘으로써 게임이 종료되었다면, 점수에 관계없이 잡히지 않은 진영이 승리한다.
+      - [x] 기물 점수 합 미달로써 게임이 종료되었다면, (진영 보너스 점수를 포함하여) 점수가 높은 진영이 승리한다.
     #### 기물 초기 위치
     - [x] 시작 위치가 고정된 기물들은 게임 시작 시 정해진 위치에 배치되어야 한다.
     - [x] `상`과 `마`는 지정한 순서에 따른 위치에 배치되어야 한다.
+    ### 데이터베이스 기능
+    - [ ] 게임의 현재 상태를 저장한다.
+      - [x] 게임판 위의 모든 기물 위치 정보를 저장한다.
+      - [x] 현재 차례(Side) 정보를 저장한다.
+      - [ ] 다음 경우에 저장된다.
+        - [x] 사용자 명령에 의한 명시적 종료
+        - [x] 게임 승패 판정으로 인한 종료
+        - [ ] 내/외부 문제로 인한 강제 종료
+    - [x] 저장된 게임 아이디를 통해 게임을 불러온다.
+    #### DB - Requirements Specification
+    아래 요구사항 명세서에서 `처음 등장하는 용어`는 이렇게 표시한다.
+    - `기물`은 `종류`와 `진영`을 가진다.
+      - 기물은 반드시 하나의 진영에 속해야 한다.
+      - 기물은 반드시 하나의 종류를 가져야 한다.
+    - 진영에는 `초(CHO)`와 `한(HAN)`이 존재한다.
+    - 기물의 종류에는 `차`, `마`, `상`, `사`, `궁`, `포`, `병/졸`이 있다.
+    - `장기판`은 가로 10개, 세로 9개의 `격자점`으로 구성된다.
+    - 기물은 격자점 위에 놓인다.
+    - 기물이 놓이지 않은 격자점이 있을 수 있다.
+    - `게임`은 각 격자점에 놓인 기물들 정보를 가진다.
+    - 게임은 현재 누구의 `차례`인지를 안다. 이 정보는 게임을 다시 시작했을 때 차례가 뒤섞이지 않도록 한다.
     ## 용어 사전
     | 용어 (영문)                  | 설명                                                  |
     |:-------------------------|:----------------------------------------------------|
     | **Row**                  | 장기판의 가로 선 (행)                                       |
     | **File**                 | 장기판의 세로 선 (열)                                       |
     | **Intersection**         | 가로선과 세로선이 만나서 생기는 격자점. 기물이 위치할 수 있는 곳               |
+    | **Straight, Orthogonal** | 직선 이동 또는 경로                                         |
+    | **Diagonal**             | 대각선 이동 또는 경로                                        |
     | **Side**                 | 진영. 초(CHO)와 한(HAN)으로 나뉨                             |
     | **Piece**                | 장기판 위에 놓이는 모든 기물의 총칭                                |
     | **Chariot**              | 차 (車). 전후좌우로 장애물이 없는 한 끝까지 이동 가능                    |
@@ Expand All / @@ -102,3 +213,4 @@ @@
     | **PassingIntersections** | `Path` 중 목적지를 제외한 나머지(= `경유지`)                      |
     | **MoveRule**             | 이동 규칙                                               |
     | **Capture**              | (어떤 기물을) 잡다, 죽이다                                    |
+    | **Point**                | 기물이 가지는 점수                                          |

build.gradle

-Original file line number
+Diff line change
@@ Expand Up / @@ -9,10 +9,12 @@ repositories { @@
     }
     dependencies {
+        implementation ('org.xerial:sqlite-jdbc:3.51.3.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')
         testImplementation('org.assertj:assertj-core')
+        testImplementation("org.mockito:mockito-core:5.23.0")
     }
     java {
@@ Expand Down @@

sql/ddl.sql

Choi-JJunho marked this conversation as resolved.

Show resolved Hide resolved

-Original file line number
+Diff line change
@@ -0,0 +1,15 @@
+    CREATE TABLE IF NOT EXISTS game (
+        game_id         INTEGER     PRIMARY KEY AUTOINCREMENT,
+        current_turn    VARCHAR(10) NOT NULL,
+        created_at      DATETIME    DEFAULT (CURRENT_TIMESTAMP)
+    );
+    CREATE TABLE IF NOT EXISTS piece (
+        game_id         INTEGER     NOT NULL,
+        position_row    INTEGER,
+        position_file   INTEGER,
+        side            VARCHAR(10) NOT NULL,
+        piece_type      VARCHAR(10) NOT NULL,
+        FOREIGN KEY (game_id) REFERENCES game(game_id),
+        PRIMARY KEY (game_id, position_row, position_file)
+    );

src/main/java/Application.java

-Original file line number
+Diff line change
@@ -1,10 +1,28 @@
     import controller.JanggiController;
+    import java.nio.file.Path;
+    import javax.sql.DataSource;
+    import repository.DatabaseInitializer;
+    import support.DBConnectionUtil;
+    import repository.JanggiGameRepository;
+    import service.JanggiService;
+    import support.TransactionTemplate;
     import view.InputView;
     import view.OutputView;
     public class Application {
         public static void main(String[] args) {
-            JanggiController janggiController = new JanggiController(new InputView(), new OutputView());
+            DataSource dataSource = DBConnectionUtil.getDataSource();
+            DatabaseInitializer initializer = new DatabaseInitializer(dataSource);
+            initializer.init(Path.of(("sql/ddl.sql")));
+            JanggiController janggiController = new JanggiController(
+                    new JanggiService(
+                            new TransactionTemplate(dataSource),
+                            new JanggiGameRepository()
+                    ),
+                    new InputView(),
+                    new OutputView()
+            );
             janggiController.run();
         }
@@ Expand Down @@

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[🚀 사이클2 - 미션 (기물 확장 + DB 적용)] 루드비코 미션 제출합니다. #325

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!