탐험 탭이 작은 행동을 아직 일일 미션이라고 부르던 것을 고침

스택을 띄워 탐험 탭을 열었더니 `오늘의 성장 효율` 카드가 같은 기능을
`일일 미션`이라고 부르고 있었다. 같은 파일 안의 다른 문구는 전부
`작은 행동`인데 이 한 줄만 옛 이름으로 남아 있었다.

앱에는 이런 어휘를 막는 검사가 있는데(`user_facing_vocabulary_test`)
Dart 문자열만 훑는다. 서버가 내려보내는 라벨은 그 그물을 그냥 지나간다.
이 줄도 그래서 살아남았다.

서버 쪽에도 같은 그물을 친다. `server/app` 아래 파이썬을 AST로 훑어
`label`·`name`·`message`처럼 화면에 그대로 실려 나가는 키의 값만 본다.
주석과 docstring은 보지 않는다 - 화면에 나가는 것은 payload의 값이다.

라벨을 옛 이름으로 되돌려 놓고 돌려 보니 그 줄을 정확히 짚었다.
서버를 다시 띄워 응답도 확인했다 - 이제 `작은 행동`으로 나간다.

Author: easygap

server/app/services/adventure.py

@@ -1243,7 +1243,7 @@ async def state_payload(db: AsyncSession, user_id: int) -> dict:
         },
         "economy": [
             {"code": "diary", "label": "마음 일기", "exp": 40, "seeds": 15},
-            {"code": "quest", "label": "일일 미션", "exp": 20, "seeds": 5},
+            {"code": "quest", "label": "작은 행동", "exp": 20, "seeds": 5},
             {"code": "dungeon", "label": "던전", "exp": 10, "seeds": 4},
             {"code": "patrol", "label": "순찰", "exp": 0, "seeds": 3},
         ],

server/tests/unit/test_user_facing_wording.py

@@ -0,0 +1,70 @@
+"""화면에 나가는 서버 문구가 옛 어휘를 쓰지 않는지 본다.
+
+앱 쪽에는 같은 검사가 있는데(`app/test/user_facing_vocabulary_test.dart`)
+서버가 내려보내는 라벨은 그 그물에 안 걸린다. 실제로 탐험 탭의 `오늘의 성장
+효율`이 같은 기능을 `일일 미션`이라고 부르고 있었다 - 같은 파일의 다른 문구는
+전부 `작은 행동`인데 이 한 줄만 남아 있었다.
+
+주석과 docstring은 보지 않는다. 화면에 나가는 것은 payload의 값이다.
+"""
+
+from __future__ import annotations
+
+import ast
+import pathlib
+
+# 쓰면 안 되는 말과 대신 쓰는 말. 세계관이 정한 어휘다.
+BANNED = {
+    "미션": "작은 행동",
+    "퀘스트": "작은 행동",
+    "몬스터": "엉킴 또는 수호자",
+    "스킬북": "기록서",
+    "레벨업": "성장",
+}
+
+# 화면에 그대로 실려 나가는 키. 코드·상태값은 보지 않는다.
+USER_FACING_KEYS = {
+    "label",
+    "name",
+    "message",
+    "description",
+    "caption",
+    "title",
+    "hint",
+    "summary",
+    "telegraph",
+    "effect_summary",
+    "unlock_hint",
+    "lock_reason",
+    "retired_reason",
+}
+
+ROOT = pathlib.Path(__file__).resolve().parents[2] / "app"
+
+
+def _offenders() -> list[str]:
+    found: list[str] = []
+    for path in sorted(ROOT.rglob("*.py")):
+        if "__pycache__" in path.parts:
+            continue
+        tree = ast.parse(path.read_text(encoding="utf-8"))
+        for node in ast.walk(tree):
+            if not isinstance(node, ast.Dict):
+                continue
+            for key, value in zip(node.keys, node.values):
+                if not (isinstance(key, ast.Constant) and key.value in USER_FACING_KEYS):
+                    continue
+                if not (isinstance(value, ast.Constant) and isinstance(value.value, str)):
+                    continue
+                for word, instead in BANNED.items():
+                    if word in value.value:
+                        found.append(
+                            f"{path.name}:{value.lineno} {value.value!r} "
+                            f"→ {word} 대신 {instead}"
+                        )
+    return found
+
+
+def test_server_labels_use_the_current_wording():
+    offenders = _offenders()
+    assert not offenders, "옛 어휘가 남아 있습니다:\n" + "\n".join(offenders)