🚀 Deploy 20260808

CHANGELOG.json

@@ -1,11 +1,26 @@
 {
   "metadata": {
-    "lastUpdated": "2026-08-08T12:00:52Z",
-    "currentVersion": "1.4.14",
+    "lastUpdated": "2026-08-08T12:45:23Z",
+    "currentVersion": "1.4.15",
     "projectType": "project_type: react # spring, flutter, react, react-native, react-native-expo, node, basic",
-    "totalReleases": 29
+    "totalReleases": 30
   },
   "releases": [
+    {
+      "version": "1.4.15",
+      "project_type": "project_type: react # spring, flutter, react, react-native, react-native-expo, node, basic",
+      "date": "2026-08-08",
+      "pr_number": 116,
+      "raw_summary": "Summary by CodeRabbit\n릴리스 노트\n\n개선\n\n스토리 진행 규칙을 분리해 안정성 향상",
+      "parsed_changes": {
+        "개선": {
+          "title": "개선",
+          "items": [
+            "스토리 진행 규칙을 분리해 안정성 향상"
+          ]
+        }
+      }
+    },
     {
       "version": "1.4.14",
       "project_type": "project_type: react # spring, flutter, react, react-native, react-native-expo, node, basic",

CHANGELOG.md

@@ -1,7 +1,16 @@
 # Changelog
 
-**현재 버전:** 1.4.14  
-**마지막 업데이트:** 2026-08-08T12:00:52Z  
+**현재 버전:** 1.4.15  
+**마지막 업데이트:** 2026-08-08T12:45:23Z  
+
+---
+
+## [1.4.15] - 2026-08-08
+
+**PR:** #116  
+
+**개선**
+- 스토리 진행 규칙을 분리해 안정성 향상
 
 ---
 

README.md

@@ -7,7 +7,7 @@
 <!-- 수정하지마세요 자동으로 동기화 됩니다 -->
 
 <!-- 수정하지마세요 자동으로 동기화 됩니다 -->
-## 최신 버전 : v1.4.13 (2026-08-08)
+## 최신 버전 : v1.4.14 (2026-08-08)
 
 [전체 업데이트 내역 보기](CHANGELOG.md)
 

docs/GAME-FLOW.md

@@ -54,8 +54,8 @@ Main2(카페)의 마지막 씬 "바닥에 돈이 떨어져 있는 것을 발견
 
 ## 점수 임계치
 
-`src/components/GameUI/BagelSelectPageComponent.jsx`의 `onSubClicked()`에 하드코딩되어 있다.
-아래는 **현재 실제 동작**이다.
+`src/game/storyFlow.js`의 `resolveNextStep()`에 정의되어 있다.
+아래는 **현재 실제 동작**이며, `src/game/storyFlow.test.js`가 이 표를 그대로 검증한다.
 
 | 스테이지 | 조건                    | 분기                                                          |
 | -------- | ----------------------- | ------------------------------------------------------------- |
@@ -97,10 +97,16 @@ Main2(카페)의 마지막 씬 "바닥에 돈이 떨어져 있는 것을 발견
 이 절의 내용은 `docs/superpowers/specs/2026-07-27-codebase-standardization-design.md` 1.2절의
 진단과 대응한다.
 
-### 1. 컴포넌트가 스토리 구조를 알고 있다
+### 1. 컴포넌트가 스토리 구조를 알고 있다 — **부분 해소**
 
-씬 전이 규칙이 `scene`/`index` 숫자 조건문 약 60줄로 컴포넌트에 박혀 있다. **씬을 하나
-추가하려면 데이터가 아니라 컴포넌트를 고쳐야 한다.**
+씬 전이 규칙이 `scene`/`index` 숫자 조건문 약 60줄로 컴포넌트에 박혀 있었다.
+
+`src/game/storyFlow.js`로 **순수 함수 추출을 완료**했다. 컴포넌트에서 `scene ===` 조건문이
+사라졌고, 전이 규칙은 이제 테스트 가능한 함수다. `src/game/storyFlow.test.js`의 25개
+테스트가 **현재 동작의 기대값 표** 역할을 한다.
+
+다만 규칙은 여전히 **코드**에 있다. JSON 데이터로 옮기는 작업이 남아 있으며,
+그때 위 테스트가 회귀 안전망이 된다.
 
 ### 2. 우연히 동작하는 분기
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "re-wave",
-  "version": "1.4.14",
+  "version": "1.4.15",
   "private": true,
   "dependencies": {
     "@testing-library/jest-dom": "^5.17.0",

src/components/GameUI/BagelSelectPageComponent.jsx

@@ -7,6 +7,7 @@ import styled from "styled-components";
 import { scoreAtom, characterNameAtom } from "../../atom/atom";
 import { ROUTES } from "../../constants/routes";
 import { markGameCompleted } from "../../game/progress";
+import { resolveNextStep, resolveStageExit } from "../../game/storyFlow";
 
 import BagelChoiceButton from "./BagelChoiceButton";
 import BagelDialogBox from "./BagelDialogBox";
@@ -175,13 +176,8 @@ const BagelSelectPageComponent = ({ backgroundImage, characterImage, storyData,
   };
 
   const onClicked = (option, i) => {
-    if (scene === 2) {
-      if (i === 0) {
-        setBase("/main4");
-      } else {
-        setBase("/main3");
-      }
-    }
+    // 다음 스테이지 목적지는 선택에 따라 갈릴 수 있다 (카페의 돈 줍기)
+    setBase(resolveStageExit(scene, i, url));
     if (option.error) {
       navigate(ROUTES.GAME_OVER);
     } else {
@@ -199,54 +195,13 @@ const BagelSelectPageComponent = ({ backgroundImage, characterImage, storyData,
     } else {
       setToggle(false);
 
-      if (scene === 2) {
-        if (index === 0) {
-          if (score >= 15 && score < 40) {
-            setIndex(1);
-          } else if (score < 15) {
-            setIndex(2);
-          } else {
-            setIndex(3);
-          }
-        } else if (index !== 1 && index !== 2) {
-          setIndex((prev) => prev + 1);
-        } else {
-          setIndex(3);
-        }
-      } else if (scene === 3) {
-        if (index === 1) {
-          if (score >= 60) {
-            setIndex(2);
-          } else if (score >= 20 && score < 60) {
-            setIndex(3);
-          } else {
-            setIndex(4);
-          }
-        } else if (index === 2 || index === 3 || index === 4) {
-          setIndex(5);
-        } else {
-          setIndex((prev) => prev + 1);
-        }
-      } else if (scene === 4) {
-        if (index === 2) {
-          if (score >= 70) {
-            setIndex(3);
-          } else {
-            setIndex(4);
-          }
-        } else {
-          setIndex((prev) => prev + 1);
-        }
-      } else if (scene === 5) {
-        if (index === 2) {
-          // 결과·엔딩 화면은 게임 완료자만 진입할 수 있다
-          markGameCompleted();
-          navigate(ROUTES.RESULT);
-        } else {
-          setIndex((prev) => prev + 1);
-        }
+      const step = resolveNextStep(scene, index, score);
+      if (step.type === "navigate") {
+        // 결과·엔딩 화면은 게임 완료자만 진입할 수 있다
+        markGameCompleted();
+        navigate(step.to);
       } else {
-        setIndex((prev) => prev + 1);
+        setIndex(step.index);
       }
     }
   };

src/game/storyFlow.js

@@ -0,0 +1,91 @@
+import { ROUTES } from "../constants/routes";
+
+/**
+ * 스토리 전이 규칙
+ *
+ * 이 규칙은 원래 `BagelSelectPageComponent`의 `onSubClicked()` 안에
+ * `scene`/`index` 숫자 조건문 약 60줄로 박혀 있었다. 컴포넌트가 스토리 구조를
+ * 알고 있어서, 씬을 하나 추가하려면 데이터가 아니라 컴포넌트를 고쳐야 했다.
+ *
+ * 여기서는 **동작을 그대로 유지한 채** 순수 함수로만 떼어냈다.
+ * 순수 함수가 되면 전 경로를 테스트로 검증할 수 있고, 그 테스트가
+ * 이후 데이터화(JSON 스키마 전환)의 회귀 안전망이 된다.
+ *
+ * 값은 바꾸지 않았다. 임계치가 이상해 보여도 그것이 현재 동작이다.
+ * 근거는 docs/GAME-FLOW.md에 기록되어 있다.
+ */
+
+/** 스테이지 종료를 뜻하는 신호. 씬 인덱스 대신 이 값을 반환한다. */
+export const STAGE_END = "STAGE_END";
+
+/**
+ * 현재 씬을 마쳤을 때 다음에 무엇을 할지 결정한다.
+ *
+ * @param {number} scene 스테이지 번호 (1~5)
+ * @param {number} index 방금 마친 씬 인덱스
+ * @param {number} score 현재까지 누적 점수
+ * @returns {{type: "scene", index: number} | {type: "navigate", to: string} | {type: "end"}}
+ */
+export const resolveNextStep = (scene, index, score) => {
+  const toScene = (i) => ({ type: "scene", index: i });
+
+  if (scene === 2) {
+    if (index === 0) {
+      if (score >= 15 && score < 40) return toScene(1);
+      if (score < 15) return toScene(2);
+      return toScene(3);
+    }
+    // 점수 분기로 1 또는 2에 들어왔다면 공통 씬(3)으로 합류한다
+    if (index === 1 || index === 2) return toScene(3);
+    return toScene(index + 1);
+  }
+
+  if (scene === 3) {
+    if (index === 1) {
+      if (score >= 60) return toScene(2);
+      if (score >= 20) return toScene(3);
+      return toScene(4);
+    }
+    if (index === 2 || index === 3 || index === 4) return toScene(5);
+    return toScene(index + 1);
+  }
+
+  if (scene === 4) {
+    // 점수가 높으면 특수 씬(맥주)을 거친다.
+    // 데이터에 `love: 60`이 선언돼 있으나 실제 동작은 70이다 (docs/GAME-FLOW.md 참조)
+    if (index === 2) {
+      return score >= 70 ? toScene(3) : toScene(4);
+    }
+    return toScene(index + 1);
+  }
+
+  if (scene === 5) {
+    // 마지막 스테이지를 마치면 결과 화면으로 나간다
+    if (index === 2) return { type: "navigate", to: ROUTES.RESULT };
+    return toScene(index + 1);
+  }
+
+  return toScene(index + 1);
+};
+
+/**
+ * 스테이지를 마쳤을 때 이동할 다음 스테이지 경로.
+ *
+ * 카페(2)에서 "돈을 줍는다"(첫 선택지)를 고르면 우산(4), 아니면 동굴(3)로 간다.
+ * `data4`의 도입부 "얻은 돈으로 편의점에서 우산을 사올 수 있었다"가 이 선택과 연결된다.
+ *
+ * @param {number} scene 스테이지 번호
+ * @param {number} choiceIndex 고른 선택지 인덱스
+ * @param {string} defaultRoute 분기가 없는 스테이지의 기본 목적지
+ * @returns {string} 다음 스테이지 경로
+ */
+export const resolveStageExit = (scene, choiceIndex, defaultRoute) => {
+  if (scene === 2) {
+    return choiceIndex === 0 ? ROUTES.MAIN4 : ROUTES.MAIN3;
+  }
+  return defaultRoute;
+};
+
+const storyFlow = { STAGE_END, resolveNextStep, resolveStageExit };
+
+export default storyFlow;