Auto-deploy from GitHub Actions - 2025-12-17 02:43:31

app/__init__.py

@@ -131,6 +131,10 @@ def create_app() -> Flask:
     def _is_postgres_uri(uri: str) -> bool:
         return uri.startswith('postgresql://') or uri.startswith('postgres://')
 
+    def _is_sqlite_uri(uri: str) -> bool:
+        # flask-sqlalchemy/sqlalchemy에서 흔히 쓰는 sqlite URI 형식들 허용
+        return uri.startswith('sqlite:///') or uri.startswith('sqlite://')
+
     def _normalize_postgres_uri(uri: str) -> str:
         """
         - postgres:// -> postgresql:// 로 정규화
@@ -159,8 +163,13 @@ def create_app() -> Flask:
         new_query = urlencode(q) if q else ''
         return urlunparse(parsed._replace(query=new_query))
 
-    # NOTE(운영): 실서버 혼선 방지를 위해 SQLite 폴백은 사용하지 않습니다.
-    # DB 장애/지연 시에는 항상 503 안내 페이지로 유도합니다.
+    # NOTE:
+    # - 로컬/개발 환경에서는 Config 기본값(SQLite)을 정상 허용합니다.
+    # - 운영에서 "PostgreSQL만 강제"하고 싶다면 환경변수로 strict 모드를 켭니다.
+    #   (예: REQUIRE_POSTGRES=1)
+    def _require_postgres_only() -> bool:
+        v = (os.environ.get('REQUIRE_POSTGRES') or os.environ.get('DB_STRICT_MODE') or '').strip().lower()
+        return v in ('1', 'true', 'yes', 'y', 'on')
 
     def _retry_sleep_seconds(attempt_idx: int) -> float:
         """
@@ -214,11 +223,20 @@ def create_app() -> Flask:
             # SQLite 폴백은 하지 않고, 서버는 살려두고 에러 페이지로 안내
             _mark_db_unavailable(last_err, phase="connect_test")
     else:
-        # 외부 DB(DATABASE_URL)가 없거나 postgres 형식이 아닌 경우: 실서버에서는 DB 사용 불가로 간주
-        _mark_db_unavailable(
-            ValueError("DATABASE_URL이 없거나 PostgreSQL 형식이 아닙니다. (운영에서는 SQLite 사용 금지)"),
-            phase="invalid_db_uri",
-        )
+        # SQLite는 로컬 기본값으로 허용 (strict 모드가 아니면 정상 부팅)
+        if _is_sqlite_uri(effective_db_uri) and not _require_postgres_only():
+            try:
+                logger.info(f"[데이터베이스] SQLite 사용: {effective_db_uri}")
+            except Exception:
+                # 로깅 실패는 무시 (부팅에 영향 주지 않음)
+                pass
+        else:
+            # 외부 DB(DATABASE_URL)가 없거나 postgres 형식이 아닌 경우:
+            # strict 모드에서는 DB 사용 불가로 간주하여 장애 모드로 전환
+            _mark_db_unavailable(
+                ValueError("DATABASE_URL이 없거나 PostgreSQL 형식이 아닙니다. (REQUIRE_POSTGRES=1이면 SQLite 사용 금지)"),
+                phase="invalid_db_uri",
+            )
 
     app.config['SQLALCHEMY_ENGINE_OPTIONS'] = engine_options
     

app/database.py

@@ -627,3 +627,24 @@ class WebtoonDurationJob(db.Model):
             'updated_at': self.updated_at.isoformat() if self.updated_at else None,
         }
 
+
+class WebtoonStageKeyMapping(db.Model):
+    """작업단계 키(예: 02, 03-2) -> 표시용 단계명(예: 02. 콘티) 매핑"""
+    __tablename__ = 'webtoon_stage_key_mapping'
+
+    id = db.Column(db.Integer, primary_key=True)
+    stage_key = db.Column(db.String(50), unique=True, nullable=False, index=True)
+    label = db.Column(db.String(200), nullable=False)
+
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow, nullable=False)
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'stage_key': self.stage_key,
+            'label': self.label,
+            'created_at': self.created_at.isoformat() if self.created_at else None,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None,
+        }
+

app/gemini_client.py

@@ -19,6 +19,15 @@ def get_gemini_api_key():
     if api_key:
         print(f"[Gemini] 환경 변수에서 API 키 가져옴 (길이: {len(api_key)}자)")
         return api_key
+
+    # 앱 컨텍스트 밖(모듈 import 시점/스크립트 실행 등)에서는 DB 조회를 시도하지 않음
+    # (SystemConfig.query가 current_app/app_context를 필요로 하므로)
+    try:
+        from flask import has_app_context
+        if not has_app_context():
+            return ''
+    except Exception:
+        return ''
     
     # DB에서 가져오기 (순환 참조 방지를 위해 여기서 임포트)
     try:
@@ -33,8 +42,6 @@ def get_gemini_api_key():
         print(f"[Gemini] DB에서 API 키 조회 실패: {e}")
         return ''
 
-GEMINI_API_KEY = get_gemini_api_key()
-
 # 사용 가능한 Gemini 모델 목록 (최신 버전 우선)
 AVAILABLE_GEMINI_MODELS = [
     'gemini-2.0-flash-exp',

app/routes.py

@@ -13,6 +13,7 @@ from app.database import (
     WebtoonProjectUpload, WebtoonProjectTask,
     WebtoonWBSAnalysis, WebtoonWBSJob,
     WebtoonProjectDuration, WebtoonEpisodeDuration, WebtoonDurationJob,
+    WebtoonStageKeyMapping,
 )
 from app.vector_db import get_vector_db
 from app.gemini_client import get_gemini_client
@@ -64,6 +65,7 @@ def get_default_admin_menu():
                     {"label": "일정 산정", "endpoint": "main.admin_webtoon_project_schedule"},
                     {"label": "제작 기간 통계/산정", "endpoint": "main.admin_webtoon_planner"},
                     {"label": "제작 단계 통계/산정", "endpoint": "main.admin_webtoon_stage_planner"},
+                    {"label": "단계키 관리 화면", "endpoint": "main.admin_webtoon_stage_keys"},
                     {"label": "웹툰 WBS", "endpoint": "main.admin_webtoon_wbs"},
                 ],
             },
@@ -2532,6 +2534,34 @@ def admin_webtoon_stage_planner():
     return render_template('admin_webtoon_stage_planner.html')
 
 
+@main_bp.route('/admin/webtoons/stage-keys')
+@admin_required
+def admin_webtoon_stage_keys():
+    """단계키(작업단계 키) 표시명 매핑 관리"""
+    return render_template('admin_webtoon_stage_keys.html')
+
+
+# 호환/오타 방지: 기존(또는 사용자가 흔히 입력하는) 단수 경로는 복수 경로로 리다이렉트
+@main_bp.route('/admin/webtoons/stage-key')
+@admin_required
+def admin_webtoon_stage_key_redirect():
+    return redirect(url_for('main.admin_webtoon_stage_keys'))
+
+
+# 호환/오타 방지: keys 경로도 stage-keys로 리다이렉트
+@main_bp.route('/admin/webtoons/keys')
+@admin_required
+def admin_webtoon_keys_redirect():
+    return redirect(url_for('main.admin_webtoon_stage_keys'))
+
+
+# 호환/오타 방지: key 경로도 stage-keys로 리다이렉트
+@main_bp.route('/admin/webtoons/key')
+@admin_required
+def admin_webtoon_key_redirect():
+    return redirect(url_for('main.admin_webtoon_stage_keys'))
+
+
 @main_bp.route('/api/webtoons/project-uploads', methods=['GET'])
 @admin_required
 def list_webtoon_project_uploads():
@@ -4107,6 +4137,76 @@ def get_webtoon_stage_episode_duration_stats():
         return jsonify({'error': f'회차별 제작단계 통계 조회 중 오류: {str(e)}'}), 500
 
 
+@main_bp.route('/api/webtoons/stage-keys', methods=['GET'])
+@admin_required
+def list_webtoon_stage_keys():
+    """단계키 표시명 매핑 목록"""
+    try:
+        rows = WebtoonStageKeyMapping.query.order_by(WebtoonStageKeyMapping.stage_key.asc()).all()
+        return jsonify({'mappings': [r.to_dict() for r in rows]}), 200
+    except Exception as e:
+        return jsonify({'error': f'단계키 매핑 조회 중 오류: {str(e)}'}), 500
+
+
+@main_bp.route('/api/webtoons/stage-keys', methods=['PUT'])
+@admin_required
+def upsert_webtoon_stage_keys():
+    """단계키 표시명 매핑 벌크 저장(업서트)"""
+    try:
+        payload = request.get_json(silent=True) or {}
+        items = payload.get('mappings') or []
+        if not isinstance(items, list):
+            return jsonify({'error': 'mappings는 배열이어야 합니다.'}), 400
+
+        cleaned = []
+        for it in items:
+            if not isinstance(it, dict):
+                continue
+            k = (str(it.get('stage_key') or '').strip())
+            v = (str(it.get('label') or '').strip())
+            if not k:
+                continue
+            cleaned.append((k, v))
+
+        # 빈 label은 삭제로 취급
+        keys_to_delete = [k for k, v in cleaned if not v]
+        if keys_to_delete:
+            WebtoonStageKeyMapping.query.filter(WebtoonStageKeyMapping.stage_key.in_(keys_to_delete)).delete(synchronize_session=False)
+
+        # upsert
+        for k, v in cleaned:
+            if not v:
+                continue
+            row = WebtoonStageKeyMapping.query.filter_by(stage_key=k).first()
+            if row:
+                row.label = v
+            else:
+                db.session.add(WebtoonStageKeyMapping(stage_key=k, label=v))
+
+        db.session.commit()
+        rows = WebtoonStageKeyMapping.query.order_by(WebtoonStageKeyMapping.stage_key.asc()).all()
+        return jsonify({'message': '저장되었습니다.', 'mappings': [r.to_dict() for r in rows]}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'error': f'단계키 매핑 저장 중 오류: {str(e)}'}), 500
+
+
+@main_bp.route('/api/webtoons/stage-keys/<path:stage_key>', methods=['DELETE'])
+@admin_required
+def delete_webtoon_stage_key(stage_key):
+    """단계키 매핑 삭제"""
+    try:
+        k = (str(stage_key or '').strip())
+        if not k:
+            return jsonify({'error': 'stage_key가 필요합니다.'}), 400
+        WebtoonStageKeyMapping.query.filter_by(stage_key=k).delete(synchronize_session=False)
+        db.session.commit()
+        return jsonify({'message': '삭제되었습니다.'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'error': f'단계키 매핑 삭제 중 오류: {str(e)}'}), 500
+
+
 @main_bp.route('/api/webtoons/duration/stage-plan', methods=['POST'])
 @admin_required
 def plan_webtoon_duration_by_stage():

templates/admin_webtoon_planner.html

@@ -229,6 +229,8 @@
     const startDateEl = document.getElementById('startDate');
     const launchDateEl = document.getElementById('launchDate');
 
+    let stageKeyMap = {};
+
     function showAlert(message, type) {
       alertContainer.innerHTML = `<div class="alert ${type}">${message}</div>`;
       setTimeout(() => { alertContainer.innerHTML = ''; }, 6000);
@@ -246,6 +248,28 @@
       return div.innerHTML;
     }
 
+    async function loadStageKeyMap() {
+      const { res, data } = await fetchJson('/api/webtoons/stage-keys');
+      if (!res.ok) {
+        stageKeyMap = {};
+        return;
+      }
+      const items = data?.mappings || [];
+      stageKeyMap = {};
+      for (const it of items) {
+        const k = String(it?.stage_key || '').trim();
+        const v = String(it?.label || '').trim();
+        if (k && v) stageKeyMap[k] = v;
+      }
+    }
+
+    function displayStageLabel(stageKey, fallbackText = '') {
+      const k = String(stageKey || '').trim();
+      const mapped = stageKeyMap[k];
+      if (mapped) return mapped;
+      return k || (fallbackText ? String(fallbackText) : '');
+    }
+
     async function loadStats() {
       const { res, data } = await fetchJson('/api/webtoons/duration/stats');
       if (!res.ok) {
@@ -286,9 +310,10 @@
         const title = (r.top_texts && r.top_texts[0]) ? r.top_texts[0].value : '';
         const tasks = (r.top_tasks || []).slice(0, 5).map(x => x.value).join(', ');
         const meta = [title, tasks].filter(Boolean).join(' / ');
+        const label = displayStageLabel(r.stage_key, title);
         return `
           <tr>
-            <td><strong>${escapeHtml(r.stage_key || '')}</strong></td>
+            <td><strong title="${escapeHtml(r.stage_key || '')}">${escapeHtml(label || '')}</strong></td>
             <td>${r.count ?? 0}</td>
             <td>${r.recommended_days ?? '-'}</td>
             <td>${r.median_days ?? '-'}</td>
@@ -327,7 +352,7 @@
         const header = `${e.episode_num}화 · ${e.start_date} ~ ${e.end_date} (${e.duration_days}일)`;
         const rows = stages.map(s => `
           <tr>
-            <td style="width:90px;"><strong>${escapeHtml(s.stage_key || '')}</strong></td>
+            <td style="width:90px;"><strong title="${escapeHtml(s.stage_key || '')}">${escapeHtml(displayStageLabel(s.stage_key, ''))}</strong></td>
             <td style="width:130px;" class="mono">${escapeHtml(s.start_date || '')}</td>
             <td style="width:130px;" class="mono">${escapeHtml(s.end_date || '')}</td>
             <td style="width:90px;">${s.duration_days || 0}</td>
@@ -339,7 +364,7 @@
             <div style="margin-top:10px;">
               <table>
                 <thead>
-                  <tr><th style="width:90px;">단계키</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
+                  <tr><th style="width:90px;">단계</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
                 </thead>
                 <tbody>${rows}</tbody>
               </table>
@@ -389,8 +414,13 @@
       showAlert('역산이 완료되었습니다.', 'success');
     }
 
-    loadStats();
-    basisEl.addEventListener('change', () => loadStats());
+    async function init() {
+      await loadStageKeyMap();
+      await loadStats();
+      basisEl.addEventListener('change', () => loadStats());
+    }
+
+    init();
   </script>
 </body>
 </html>

templates/admin_webtoon_stage_keys.html

@@ -0,0 +1,223 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>단계키 관리 - SOY NV AI</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap" rel="stylesheet">
+  <style>
+    :root{
+      --bg:#f6f7fb;--card:#fff;--text:#202124;--muted:#5f6368;--border:#e5e7eb;--border-strong:#dadce0;
+      --primary:#1a73e8;--primary-hover:#1557b0;--shadow:0 10px 24px rgba(17,24,39,.08);--radius:12px;
+      --danger:#c5221f;
+    }
+    *{margin:0;padding:0;box-sizing:border-box}
+    body{
+      font-family:'Inter', -apple-system, BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;
+      background: radial-gradient(1200px 600px at 20% -10%, rgba(26,115,232,0.10), rgba(255,255,255,0)) , var(--bg);
+      color:var(--text);overflow-x:hidden
+    }
+    .container{max-width:1180px;margin:22px auto;padding:0 24px}
+    .page-header{margin:8px 0 14px}
+    .page-header h1{font-size:18px;font-weight:700;letter-spacing:-.2px}
+    .page-header p{margin-top:6px;color:var(--muted);font-size:13px;line-height:1.6}
+
+    .card{background:var(--card);border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;box-shadow:var(--shadow);margin-bottom:14px}
+    .card-header{padding:14px 16px;border-bottom:1px solid var(--border);display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;background:linear-gradient(to bottom,#fff,#fbfbff)}
+    .card-title{font-size:15px;font-weight:700}
+    .card-body{padding:16px}
+    .row{display:flex;gap:10px;flex-wrap:wrap;align-items:center}
+    .btn{padding:10px 12px;border:1px solid var(--border);border-radius:10px;font-size:13px;font-weight:700;cursor:pointer;background:#fff;color:var(--text)}
+    .btn-primary{background:var(--primary);border-color:var(--primary);color:#fff}
+    .btn-primary:hover{background:var(--primary-hover);border-color:var(--primary-hover)}
+    .btn-danger{background:var(--danger);border-color:var(--danger);color:#fff}
+    .btn-danger:hover{filter:brightness(.95)}
+    .btn:disabled{opacity:.55;cursor:not-allowed}
+    .mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:12px}
+    .alert{margin-bottom:12px;padding:10px 12px;border-radius:10px;font-size:13px;border:1px solid transparent}
+    .alert.success{background:#e6f4ea;border-color:#b7dfc0;color:#137333}
+    .alert.error{background:#fce8e6;border-color:#f6aea9;color:#c5221f}
+    .hint{color:var(--muted);font-size:12px;line-height:1.5}
+
+    table{width:100%;border-collapse:collapse}
+    thead th{text-align:left;font-size:12px;color:var(--muted);padding:10px 8px;border-bottom:1px solid var(--border);background:#fbfbff}
+    tbody td{font-size:13px;padding:10px 8px;border-bottom:1px solid var(--border);vertical-align:middle}
+    tbody tr:hover{background:#fafbff}
+    .input{
+      width:100%;
+      padding:10px 12px;border:1px solid var(--border-strong);border-radius:10px;font-size:13px;outline:none;background:#fff;
+    }
+    .input[readonly]{background:#f7f7fb;color:var(--muted)}
+  </style>
+</head>
+<body>
+  {% set admin_nav_title = '웹툰' %}
+  {% set admin_nav_icon = '🗂️' %}
+  {% include '_admin_nav.html' %}
+
+  <div class="container">
+    <div class="page-header">
+      <h1>단계키 관리</h1>
+      <p>작업단계 키(예: <span class="mono">02</span>, <span class="mono">03-2</span>)를 표시용 단계명(예: <span class="mono">02. 콘티</span>)으로 매핑합니다. 이 설정은 <strong>제작 기간 통계/산정</strong>, <strong>제작 단계 통계/산정</strong> 등 단계키 표시 화면에 적용됩니다.</p>
+    </div>
+
+    <div id="alertContainer"></div>
+
+    <div class="card">
+      <div class="card-header">
+        <div class="card-title">매핑 목록</div>
+        <div class="row">
+          <button class="btn" type="button" onclick="reload()">새로고침</button>
+          <button class="btn" type="button" onclick="addRow()">추가</button>
+          <button id="saveBtn" class="btn btn-primary" type="button" onclick="saveAll()">저장</button>
+        </div>
+      </div>
+      <div class="card-body">
+        <table>
+          <thead>
+            <tr>
+              <th style="width:200px;">단계키</th>
+              <th>표시명</th>
+              <th style="width:160px;">업데이트</th>
+              <th style="width:110px;">삭제</th>
+            </tr>
+          </thead>
+          <tbody id="tbody">
+            <tr><td colspan="4" style="text-align:center; color: var(--muted); padding: 18px;">불러오는 중...</td></tr>
+          </tbody>
+        </table>
+        <div class="hint" style="margin-top:10px;">
+          - <strong>저장</strong>은 전체 업서트(추가/수정)입니다.<br>
+          - 표시명을 비우고 저장하면 해당 단계키 매핑은 삭제됩니다.
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    const alertContainer = document.getElementById('alertContainer');
+    const tbody = document.getElementById('tbody');
+    const saveBtn = document.getElementById('saveBtn');
+
+    function showAlert(message, type) {
+      alertContainer.innerHTML = `<div class="alert ${type}">${message}</div>`;
+      setTimeout(() => { alertContainer.innerHTML = ''; }, 6000);
+    }
+    async function fetchJson(url, options = {}) {
+      const res = await fetch(url, { credentials: 'include', ...options });
+      const text = await res.text();
+      let data = null;
+      try { data = text ? JSON.parse(text) : null; } catch { data = { raw: text }; }
+      return { res, data };
+    }
+    function escapeHtml(text) {
+      const div = document.createElement('div');
+      div.textContent = text == null ? '' : String(text);
+      return div.innerHTML;
+    }
+
+    function rowTemplate(item, { isNew } = { isNew: false }) {
+      const k = item?.stage_key || '';
+      const v = item?.label || '';
+      const updatedAt = item?.updated_at || '';
+      return `
+        <tr data-new="${isNew ? '1' : '0'}" data-key="${escapeHtml(k)}">
+          <td>
+            <input class="input mono js-key" ${isNew ? '' : 'readonly'} placeholder="예: 02 또는 03-2" value="${escapeHtml(k)}" />
+          </td>
+          <td>
+            <input class="input js-label" placeholder="예: 02. 콘티" value="${escapeHtml(v)}" />
+          </td>
+          <td class="mono" style="color:var(--muted)">${escapeHtml(updatedAt)}</td>
+          <td>
+            <button class="btn btn-danger" type="button" onclick="deleteRow(this)">삭제</button>
+          </td>
+        </tr>
+      `;
+    }
+
+    async function reload() {
+      const { res, data } = await fetchJson('/api/webtoons/stage-keys');
+      if (!res.ok) {
+        showAlert(data?.error || `조회 실패 (${res.status})`, 'error');
+        tbody.innerHTML = `<tr><td colspan="4" style="text-align:center; color: var(--muted); padding: 18px;">조회 실패</td></tr>`;
+        return;
+      }
+      const items = data?.mappings || [];
+      if (!items.length) {
+        tbody.innerHTML = `<tr><td colspan="4" style="text-align:center; color: var(--muted); padding: 18px;">매핑이 없습니다. “추가”로 등록하세요.</td></tr>`;
+        return;
+      }
+      tbody.innerHTML = items.map(it => rowTemplate(it, { isNew: false })).join('');
+    }
+
+    function addRow() {
+      const html = rowTemplate({ stage_key: '', label: '' }, { isNew: true });
+      if (tbody.querySelector('tr td[colspan]')) {
+        tbody.innerHTML = html;
+      } else {
+        tbody.insertAdjacentHTML('beforeend', html);
+      }
+      // 새 행의 key 입력에 포커스
+      const last = tbody.querySelector('tr:last-child .js-key');
+      if (last) last.focus();
+    }
+
+    function collectMappings() {
+      const rows = Array.from(tbody.querySelectorAll('tr')).filter(tr => !tr.querySelector('td[colspan]'));
+      const out = [];
+      for (const tr of rows) {
+        const k = (tr.querySelector('.js-key')?.value || '').trim();
+        const v = (tr.querySelector('.js-label')?.value || '').trim();
+        if (!k) continue;
+        out.push({ stage_key: k, label: v });
+      }
+      return out;
+    }
+
+    async function saveAll() {
+      const mappings = collectMappings();
+      saveBtn.disabled = true;
+      const { res, data } = await fetchJson('/api/webtoons/stage-keys', {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ mappings })
+      });
+      saveBtn.disabled = false;
+      if (!res.ok) {
+        showAlert(data?.error || `저장 실패 (${res.status})`, 'error');
+        return;
+      }
+      showAlert('저장되었습니다.', 'success');
+      await reload();
+    }
+
+    async function deleteRow(btn) {
+      const tr = btn.closest('tr');
+      const isNew = (tr?.getAttribute('data-new') === '1');
+      const key = (tr?.querySelector('.js-key')?.value || '').trim();
+      if (isNew) {
+        tr.remove();
+        return;
+      }
+      if (!key) {
+        tr.remove();
+        return;
+      }
+      if (!confirm(`'${key}' 매핑을 삭제할까요?`)) return;
+      const { res, data } = await fetchJson(`/api/webtoons/stage-keys/${encodeURIComponent(key)}`, { method: 'DELETE' });
+      if (!res.ok) {
+        showAlert(data?.error || `삭제 실패 (${res.status})`, 'error');
+        return;
+      }
+      showAlert('삭제되었습니다.', 'success');
+      await reload();
+    }
+
+    reload();
+  </script>
+</body>
+</html>
+
+

templates/admin_webtoon_stage_planner.html

@@ -205,6 +205,8 @@
     const epStageSummary = document.getElementById('epStageSummary');
     const stagePlanWrap = document.getElementById('stagePlanWrap');
 
+    let stageKeyMap = {};
+
     function showAlert(message, type) {
       alertContainer.innerHTML = `<div class="alert ${type}">${message}</div>`;
       setTimeout(() => { alertContainer.innerHTML = ''; }, 6000);
@@ -222,6 +224,26 @@
       return div.innerHTML;
     }
 
+    async function loadStageKeyMap() {
+      const { res, data } = await fetchJson('/api/webtoons/stage-keys');
+      if (!res.ok) {
+        stageKeyMap = {};
+        return;
+      }
+      const items = data?.mappings || [];
+      stageKeyMap = {};
+      for (const it of items) {
+        const k = String(it?.stage_key || '').trim();
+        const v = String(it?.label || '').trim();
+        if (k && v) stageKeyMap[k] = v;
+      }
+    }
+
+    function displayStageLabel(stageKey) {
+      const k = String(stageKey || '').trim();
+      return stageKeyMap[k] || k;
+    }
+
     let cachedEpStats = null;
 
     async function loadEpStageStats() {
@@ -261,7 +283,7 @@
       }
       epStageTbody.innerHTML = stages.map(s => `
         <tr>
-          <td><strong>${escapeHtml(s.stage_key || '')}</strong></td>
+          <td><strong title="${escapeHtml(s.stage_key || '')}">${escapeHtml(displayStageLabel(s.stage_key || ''))}</strong></td>
           <td>${s.count ?? 0}</td>
           <td>${s.recommended_days ?? '-'}</td>
           <td>${s.median_days ?? '-'}</td>
@@ -296,7 +318,7 @@
         const header = `${e.episode_num}화 · ${e.start_date} ~ ${e.end_date} (${e.duration_days}일)`;
         const rows = (e.stages || []).map(s => `
           <tr>
-            <td style="width:90px;"><strong>${escapeHtml(s.stage_key || '')}</strong></td>
+            <td style="width:90px;"><strong title="${escapeHtml(s.stage_key || '')}">${escapeHtml(displayStageLabel(s.stage_key || ''))}</strong></td>
             <td style="width:130px;" class="mono">${escapeHtml(s.start_date || '')}</td>
             <td style="width:130px;" class="mono">${escapeHtml(s.end_date || '')}</td>
             <td style="width:90px;">${s.duration_days || 0}</td>
@@ -308,7 +330,7 @@
             <div style="margin-top:10px;">
               <table>
                 <thead>
-                  <tr><th style="width:90px;">단계키</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
+                  <tr><th style="width:90px;">단계</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
                 </thead>
                 <tbody>${rows}</tbody>
               </table>
@@ -384,12 +406,12 @@
           <div style="margin-top:10px;">
             <table>
               <thead>
-                <tr><th style="width:90px;">단계키</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
+                <tr><th style="width:90px;">단계</th><th style="width:130px;">시작</th><th style="width:130px;">종료</th><th style="width:90px;">일수</th></tr>
               </thead>
               <tbody>
                 ${g.map(s => `
                   <tr>
-                    <td><strong>${escapeHtml(s.stage_key || '')}</strong></td>
+                    <td><strong title="${escapeHtml(s.stage_key || '')}">${escapeHtml(displayStageLabel(s.stage_key || ''))}</strong></td>
                     <td class="mono">${escapeHtml(s.start_date || '')}</td>
                     <td class="mono">${escapeHtml(s.end_date || '')}</td>
                     <td>${s.duration_days || 0}</td>
@@ -430,9 +452,14 @@
       showAlert('일제 진행 역산이 완료되었습니다.', 'success');
     }
 
-    episodeSelect.addEventListener('change', () => renderEpStageTable(parseInt(episodeSelect.value, 10) || 1));
-    basisEl.addEventListener('change', () => loadAll());
-    loadAll();
+    async function init() {
+      await loadStageKeyMap();
+      episodeSelect.addEventListener('change', () => renderEpStageTable(parseInt(episodeSelect.value, 10) || 1));
+      basisEl.addEventListener('change', () => loadAll());
+      await loadAll();
+    }
+
+    init();
   </script>
 </body>
 </html>