feat(i18n): 모듈 displayName·description 다국어 키 전환 및 언어 설정 서버 저장

- module.json: displayName·description을 i18n 키로 전환 (ledger:displayName, ledger:description)
- 번역 파일(ko/en): displayName·description 키 추가
- ModuleManifest + parseModuleJson: description 필드 추가
- GET /core/modules/me: description·displayName 응답에 포함
- AppShell: t(mod.displayName) 으로 사이드바 모듈명 번역 적용
- HomeView: 모듈 카드에 displayName·description 표시 복원
- SettingsView: 모듈 목록에 displayName·description 표시, settings-module-desc 스타일 추가
- 005_add_user_language.sql: users.language 컬럼 추가 (DEFAULT 'en')
- GET/PATCH /core/users/me/settings: 언어 설정 서버 저장·조회 API 구현
- 로그인 후 서버 언어 설정 로드, 저장 시 PATCH 호출 연동
- i18n 기본 언어 ko → en 변경

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SOIV

apps/api/src/db/migrations/core/005_add_user_language.sql

@@ -0,0 +1,6 @@
+-- ── 005_add_user_language.sql ────────────────────────────────────
+-- users 테이블에 언어 설정 컬럼 추가.
+-- i18n 언어 코드 (예: 'ko', 'en') 를 서버에 저장해
+-- 기기를 바꿔도 동일한 언어 설정이 유지되도록 한다.
+
+ALTER TABLE users ADD COLUMN IF NOT EXISTS language TEXT NOT NULL DEFAULT 'en';

apps/api/src/integration/smoke.test.ts

@@ -8,6 +8,7 @@ describe("api integration smoke", () => {
       {
         name: "ledger",
         displayName: "가계부",
+        description: "수입과 지출을 기록하고 관리하는 가계부 모듈",
         version: "1.0.0",
         enabled: true,
         dependencies: [],

apps/api/src/loader/index.test.ts

@@ -58,6 +58,7 @@ describe("api module loader", () => {
       {
         name: "subscription",
         displayName: "구독 관리",
+        description: "",
         version: "1.0.0",
         enabled: true,
         dependencies: [],

apps/api/src/loader/index.ts

@@ -9,6 +9,7 @@ export interface ModuleRoutes {
 export interface ModuleManifest {
   name: string;
   displayName: string;
+  description: string;
   version: string;
   enabled: boolean;
   dependencies: string[];
@@ -39,6 +40,7 @@ export function parseModuleJson(content: string): ModuleManifest {
   return {
     name: parsed.name ?? "",
     displayName: parsed.displayName ?? parsed.name ?? "",
+    description: parsed.description ?? "",
     version: parsed.version ?? "0.0.0",
     enabled: parsed.enabled ?? false,
     dependencies: parsed.dependencies ?? [],

apps/api/src/routes/core.ts

@@ -84,6 +84,7 @@ export function createCoreRouter(services: AppServices): Router {
       const result = registryModules.map((mod) => ({
         name: mod.name,
         displayName: mod.manifest.displayName,
+        description: mod.manifest.description,
         basePath: mod.basePath,
         version: mod.manifest.version,
         // user_modules 레코드 없으면 기본 활성
@@ -179,5 +180,67 @@ export function createCoreRouter(services: AppServices): Router {
     }
   });
 
+  // ── 유저 설정 API ──────────────────────────────────────────────
+
+  /**
+   * GET /core/users/me/settings — 현재 유저의 앱 설정 반환
+   *
+   * 현재 지원 항목: language (언어 코드, 예: 'ko' | 'en')
+   */
+  router.get('/users/me/settings', auth, async (req, res) => {
+    try {
+      const { getDb } = await import('@fieldstack/core');
+      const database = await getDb();
+
+      type Row = { language: string };
+      const [row] = await database.query<Row>(
+        'SELECT language FROM users WHERE id = $1',
+        [req.auth!.userId],
+      );
+
+      res.json({ success: true, data: { language: row?.language ?? 'ko' } });
+    } catch (err) {
+      res.status(500).json({ success: false, error: (err as Error).message });
+    }
+  });
+
+  /**
+   * PATCH /core/users/me/settings — 현재 유저의 앱 설정 저장
+   *
+   * Body: { language?: string }
+   * 지원 언어 코드: 'ko', 'en'
+   */
+  router.patch('/users/me/settings', auth, async (req, res) => {
+    const schema = z.object({
+      language: z.enum(['ko', 'en']).optional(),
+    });
+
+    const parsed = schema.safeParse(req.body);
+    if (!parsed.success) {
+      res.status(400).json({ success: false, error: parsed.error.message });
+      return;
+    }
+
+    const { language } = parsed.data;
+    if (!language) {
+      res.status(400).json({ success: false, error: '변경할 설정이 없습니다.' });
+      return;
+    }
+
+    try {
+      const { getDb } = await import('@fieldstack/core');
+      const database = await getDb();
+
+      await database.query(
+        'UPDATE users SET language = $1, updated_at = $2 WHERE id = $3',
+        [language, new Date().toISOString(), req.auth!.userId],
+      );
+
+      res.json({ success: true, data: { language } });
+    } catch (err) {
+      res.status(500).json({ success: false, error: (err as Error).message });
+    }
+  });
+
   return router;
 }

apps/web/src/components/AppShell.tsx

@@ -179,17 +179,17 @@ export function AppShell({
                     <button
                       type="button"
                       className="shell-nav-item"
-                      data-label={mod.displayName || mod.name}
+                      data-label={t(mod.displayName, { defaultValue: mod.name })}
                       aria-current={isActive && !subRoute ? "page" : undefined}
                       onClick={() => { window.location.hash = mod.name; closeMobileMenu(); }}
                     >
                       <span className="shell-nav-icon" aria-hidden="true">📦</span>
-                      <span className="shell-nav-text">{mod.displayName || mod.name}</span>
+                      <span className="shell-nav-text">{t(mod.displayName, { defaultValue: mod.name })}</span>
                     </button>
 
                     {/* 서브 네비게이션 — 해당 모듈이 활성화됐을 때만 표시 */}
                     {isActive && subItems && subItems.length > 0 && (
-                      <ul className="shell-subnav-list" aria-label={t('sidebar.subMenu', { name: mod.displayName })}>
+                      <ul className="shell-subnav-list" aria-label={t('sidebar.subMenu', { name: t(mod.displayName, { defaultValue: mod.name }) })}>
                         {subItems.map((sub) => {
                           const hash = sub.key ? `${mod.name}/${sub.key}` : mod.name;
                           const isSubActive = subRoute === sub.key;

apps/web/src/i18n/index.ts

@@ -11,8 +11,8 @@ const savedLang = (() => {
 i18n
   .use(initReactI18next)
   .init({
-    lng: savedLang ?? 'ko',
-    fallbackLng: 'ko',
+    lng: savedLang ?? 'en',
+    fallbackLng: 'en',
     resources: {
       ko: { common: ko },
       en: { common: en },

apps/web/src/main.tsx

@@ -2,10 +2,11 @@ import { type FormEvent, useEffect, useMemo, useState } from "react";
 import { createRoot } from "react-dom/client";
 import { useTranslation } from "react-i18next";
 
-import { setSessionExpiredHandler } from "./lib/apiFetch";
+import { setSessionExpiredHandler, apiFetch } from "./lib/apiFetch";
 
 // i18n 초기화 — 다른 import보다 먼저 로드되어야 함
 import './i18n/index';
+import { changeLanguage } from './i18n/index';
 
 import "./styles/global.css";
 import "./styles/login.css";
@@ -268,6 +269,17 @@ function App() {
     try {
       if (localStorage.getItem(LS.firstVisitShown) !== "true") setIsFirstVisit(true);
     } catch { /* ignore */ }
+
+    // 서버에 저장된 언어 설정 로드 (실패해도 무음 처리)
+    apiFetch("/core/users/me/settings")
+      .then((r) => r.json())
+      .then((json: { success: boolean; data?: { language: string } }) => {
+        if (json.success && json.data?.language) {
+          void changeLanguage(json.data.language);
+        }
+      })
+      .catch(() => { /* 언어 설정 로드 실패는 무음 처리 */ });
+
     const target = redirectAfterLogin ?? startupRoute;
     setRedirectAfterLogin(null);
     navigate(target);

apps/web/src/styles/settings.css

@@ -164,24 +164,32 @@
 
 .settings-module-info {
   display: flex;
-  align-items: center;
-  gap: 8px;
+  flex-direction: column;
+  gap: 2px;
   min-width: 0;
 }
 
 .settings-module-name {
+  display: flex;
+  align-items: center;
+  gap: 6px;
   font-size: 13px;
   font-weight: 600;
   color: var(--text);
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
 }
 
 .settings-module-version {
   font-size: 11px;
   color: var(--text-faint);
-  flex-shrink: 0;
+  font-weight: 400;
+}
+
+.settings-module-desc {
+  font-size: 12px;
+  color: var(--text-muted);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
 .settings-dialog-footer {

apps/web/src/views/HomeView.tsx

@@ -21,6 +21,8 @@ const MOCK_RECENT_ACTIVITY = [
 
 interface InstalledModule {
   name: string;
+  displayName: string;
+  description: string;
   basePath: string;
   enabled: boolean;
 }
@@ -117,8 +119,8 @@ export function HomeView({
                     onClick={() => { window.location.hash = mod.name; }}
                   >
                     <p className="module-card-icon">{MODULE_ICONS[mod.name] ?? "🧩"}</p>
-                    <p className="module-card-name">{mod.name}</p>
-                    <p className="module-card-desc">{t('home.openModule')}</p>
+                    <p className="module-card-name">{t(mod.displayName, { defaultValue: mod.name })}</p>
+                    <p className="module-card-desc">{t(mod.description, { defaultValue: mod.description })}</p>
                   </button>
                 ))}
               </div>