Restore full UI + add page range selection

app_gradio.py

@@ -1,170 +1,659 @@
-"""
-app_gradio.py
-
-Gradio 웹 UI — 악보(PDF/PNG/JPG) 업로드 → MML 변환 결과 반환.
-
-실행:
-    python app_gradio.py
-
-외부 접속:
-    python app_gradio.py --share
-
-Hugging Face Spaces 배포:
-    Dockerfile에서 ENTRYPOINT로 실행됨
-"""
-
-import argparse
-import datetime
-import os
-import tempfile
-from pathlib import Path
-
-import gradio as gr
-
-from core.convert_pipeline import run_score_pipeline
-
-
-SUPPORTED_EXTENSIONS = [".pdf", ".png", ".jpg", ".jpeg"]
-MAX_PDF_PAGES = int(os.environ.get("MAX_PDF_PAGES", "5"))
-
-_PREPROCESS_MAP = {"없음": "none", "Otsu": "otsu", "Adaptive": "adaptive", "대비강화": "contrast"}
-_UPSCALE_MAP = {
-    "없음": "none",
-    "PIL 2×": "pil_2", "PIL 3×": "pil_3",
-}
-
-
-def _check_pdf_pages(file_path: str) -> str | None:
-    """PDF 페이지 수 제한 검사. 초과 시 에러 메시지 반환."""
-    if Path(file_path).suffix.lower() != ".pdf":
-        return None
-    try:
-        import fitz
-        doc = fitz.open(file_path)
-        count = doc.page_count
-        doc.close()
-        if count > MAX_PDF_PAGES:
-            return f"PDF가 {count}페이지입니다. 최대 {MAX_PDF_PAGES}페이지까지 지원합니다."
-    except Exception:
-        pass
-    return None
-
-
-def convert(file_path: str, preprocess: str, dpi: int, upscale: str, page_start: int, page_end: int, progress=gr.Progress()) -> tuple[str, str | None, list, list, str]:
-    if file_path is None:
-        return "", None, [], [], "파일을 업로드해주세요."
-
-    ext = Path(file_path).suffix.lower()
-    if ext not in SUPPORTED_EXTENSIONS:
-        return "", None, [], [], f"지원하지 않는 파일 형식입니다: {ext}\n지원 형식: PDF, PNG, JPG"
-
-    page_err = _check_pdf_pages(file_path)
-    if page_err and page_start == 0 and page_end == 0:
-        return "", None, [], [], page_err
-
-    try:
-        combined, mxl_paths, xml_paths, warnings = run_score_pipeline(
-            input_path=file_path,
-            preprocess_mode=_PREPROCESS_MAP.get(preprocess, "none"),
-            dpi=dpi,
-            upscale_mode=_UPSCALE_MAP.get(upscale, "none"),
-            on_progress=lambda frac, desc: progress(frac, desc=desc),
-            correct_xml=False,
-            page_start=int(page_start),
-            page_end=int(page_end),
-        )
-    except Exception as e:
-        return "", None, [], [], f"변환 중 오류 발생:\n{e}"
-
-    # MML 파일 생성: 입력파일명_mml_YYYYMMDD_HHMMSS.mml
-    stem = Path(file_path).stem
-    ts = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
-    mml_filename = f"{stem}_mml_{ts}.mml"
-    mml_path = Path(tempfile.gettempdir()) / mml_filename
-    mml_path.write_text(combined, encoding="utf-8")
-
-    warnings_text = "\n".join(f"[WARN] {w}" for w in warnings) if warnings else "경고 없음"
-    return combined, str(mml_path), mxl_paths, xml_paths, warnings_text
-
-
-def build_ui() -> gr.Blocks:
-    with gr.Blocks(title="악보 → MML 변환기") as demo:
-        gr.Markdown("# 악보 → MML 변환기")
-        gr.Markdown("PDF 또는 이미지 악보를 업로드하면 마비노기 MML로 변환해드립니다.")
-
-        with gr.Row():
-            with gr.Column():
-                file_input = gr.File(
-                    label="악보 파일 (PDF, PNG, JPG)",
-                    file_types=[".pdf", ".png", ".jpg", ".jpeg"],
-                )
-                preprocess_radio = gr.Radio(
-                    choices=["없음", "Otsu", "Adaptive", "대비강화"],
-                    value="없음",
-                    label="전처리 (없음=원본, Otsu=깨끗한스캔, Adaptive=조명불균일, 대비강화=흐린스캔)",
-                )
-                dpi = gr.Radio(
-                    choices=[150, 300, 450, 600],
-                    value=300,
-                    label="DPI (PDF만 해당, 300 권장)",
-                )
-                upscale_radio = gr.Radio(
-                    choices=["없음", "PIL 2×", "PIL 3×"],
-                    value="없음",
-                    label="업스케일 (PIL 리사이즈 — 저해상도 스캔에 효과적)",
-                )
-                with gr.Row():
-                    page_start_input = gr.Number(
-                        value=0, label="시작 페이지 (0=처음부터)", minimum=0, precision=0,
-                    )
-                    page_end_input = gr.Number(
-                        value=0, label="끝 페이지 (0=끝까지)", minimum=0, precision=0,
-                    )
-                convert_btn = gr.Button("변환 시작", variant="primary")
-
-            with gr.Column():
-                mml_output = gr.Textbox(
-                    label="MML 결과  (위: 전체화음 N파트 / 구분선 / 아래: 3파트)",
-                    lines=25,
-                    placeholder="변환 결과가 여기에 표시됩니다.",
-                )
-                mml_file_output = gr.File(
-                    label="MML 다운로드",
-                    file_count="single",
-                )
-                mxl_output = gr.File(
-                    label="MXL 다운로드 (압축 MusicXML)",
-                    file_count="multiple",
-                )
-                xml_output = gr.File(
-                    label="XML 다운로드 (Soundslice 등 호환)",
-                    file_count="multiple",
-                )
-                warnings_output = gr.Textbox(
-                    label="경고",
-                    lines=4,
-                    placeholder="경고 메시지",
-                )
-
-        convert_btn.click(
-            fn=convert,
-            inputs=[file_input, preprocess_radio, dpi, upscale_radio, page_start_input, page_end_input],
-            outputs=[mml_output, mml_file_output, mxl_output, xml_output, warnings_output],
-        )
-
-    return demo
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--share", action="store_true", help="외부 공유 링크 생성")
-    parser.add_argument("--port", type=int, default=7860, help="포트 번호 (기본: 7860)")
-    args = parser.parse_args()
-
-    demo = build_ui()
-    demo.queue(max_size=10, default_concurrency_limit=1)
-    demo.launch(
-        share=args.share,
-        server_name="0.0.0.0",
-        server_port=args.port,
-    )
+"""
+app_gradio.py
+
+Gradio 웹 UI — 악보(PDF/PNG/JPG) 업로드 → MML 변환 결과 반환.
+
+실행:
+    python app_gradio.py
+
+외부 접속:
+    python app_gradio.py --share
+
+Hugging Face Spaces 배포:
+    Dockerfile에서 ENTRYPOINT로 실행됨
+"""
+
+import argparse
+import datetime
+import json
+import logging
+import os
+import re
+import tempfile
+import threading
+from pathlib import Path
+from typing import List
+
+import gradio as gr
+
+from core.convert_pipeline import run_score_pipeline
+
+logger = logging.getLogger(__name__)
+
+SUPPORTED_EXTENSIONS = [".pdf", ".png", ".jpg", ".jpeg"]
+MAX_PDF_PAGES = int(os.environ.get("MAX_PDF_PAGES", "5"))
+_SEP = "-" * 40
+
+# ---------------------------------------------------------------------------
+# Persistent stats via Hugging Face Dataset repo
+# ---------------------------------------------------------------------------
+_STATS_REPO = os.environ.get("STATS_REPO", "Coconuttttt/score-to-mml-stats")
+_STATS_FILE = "stats.json"
+_stats_lock = threading.Lock()
+
+# Real-time active conversion counter
+_active_lock = threading.Lock()
+_active_count = 0
+
+
+def _hf_api():
+    """Get HfApi instance (lazy import — huggingface_hub ships with gradio)."""
+    try:
+        from huggingface_hub import HfApi
+        token = os.environ.get("HF_TOKEN")
+        return HfApi(token=token) if token else None
+    except ImportError:
+        return None
+
+
+def _load_stats() -> dict:
+    """Download stats.json from HF Dataset repo. Returns dict or empty."""
+    api = _hf_api()
+    if not api:
+        return {}
+    try:
+        from huggingface_hub import hf_hub_download
+        token = os.environ.get("HF_TOKEN")
+        path = hf_hub_download(
+            repo_id=_STATS_REPO, filename=_STATS_FILE,
+            repo_type="dataset", token=token,
+            force_download=True,
+        )
+        with open(path, encoding="utf-8") as f:
+            return json.load(f)
+    except Exception:
+        return {}
+
+
+def _save_stats(data: dict):
+    """Upload stats.json to HF Dataset repo."""
+    api = _hf_api()
+    if not api:
+        return
+    try:
+        tmp = Path(tempfile.gettempdir()) / _STATS_FILE
+        tmp.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
+        api.upload_file(
+            path_or_fileobj=str(tmp),
+            path_in_repo=_STATS_FILE,
+            repo_id=_STATS_REPO,
+            repo_type="dataset",
+        )
+    except Exception as e:
+        logger.warning("stats save failed: %s", e)
+
+
+def _bump_stat(key: str, extra: dict | None = None):
+    """Increment today's counter + hourly bucket (thread-safe).
+    extra: optional dict to merge into today's record (e.g. error details).
+    """
+    now = datetime.datetime.now()
+    today = now.strftime("%Y-%m-%d")
+    hour = now.strftime("%H")
+    with _stats_lock:
+        data = _load_stats()
+        if today not in data:
+            data[today] = {"visits": 0, "conversions": 0, "errors": 0, "hourly": {}}
+        # Migrate old format
+        if "hourly" not in data[today]:
+            data[today]["hourly"] = {}
+        if "errors" not in data[today]:
+            data[today]["errors"] = 0
+        # Daily total
+        data[today][key] = data[today].get(key, 0) + 1
+        # Hourly bucket
+        if hour not in data[today]["hourly"]:
+            data[today]["hourly"][hour] = {"visits": 0, "conversions": 0, "errors": 0}
+        data[today]["hourly"][hour][key] = data[today]["hourly"][hour].get(key, 0) + 1
+        # Track peak concurrent
+        with _active_lock:
+            cur = _active_count
+        peak = data[today].get("peak_concurrent", 0)
+        if cur > peak:
+            data[today]["peak_concurrent"] = cur
+        # Merge extra (e.g. recent error messages)
+        if extra:
+            if "recent_errors" not in data[today]:
+                data[today]["recent_errors"] = []
+            data[today]["recent_errors"].append(extra)
+            # Keep only last 10 errors per day
+            data[today]["recent_errors"] = data[today]["recent_errors"][-10:]
+        _save_stats(data)
+
+
+def _record_visit():
+    """Called on page load via demo.load()."""
+    threading.Thread(target=_bump_stat, args=("visits",), daemon=True).start()
+
+
+def _record_conversion():
+    """Called after successful conversion."""
+    threading.Thread(target=_bump_stat, args=("conversions",), daemon=True).start()
+
+
+def _record_error(error_msg: str):
+    """Called on conversion failure — logs error type + message."""
+    now = datetime.datetime.now().strftime("%H:%M:%S")
+    short = str(error_msg)[:200]
+    extra = {"time": now, "msg": short}
+    threading.Thread(target=_bump_stat, args=("errors", extra), daemon=True).start()
+
+
+def _get_dashboard() -> str:
+    """Build admin dashboard text from stats."""
+    with _active_lock:
+        active = _active_count
+    data = _load_stats()
+    today = datetime.date.today().isoformat()
+    lines = []
+    lines.append(f"=== 실시간 ===")
+    lines.append(f"현재 변환 중: {active}건")
+    lines.append("")
+
+    # Today
+    td = data.get(today, {})
+    lines.append(f"=== 오늘 ({today}) ===")
+    lines.append(f"방문: {td.get('visits', 0)}  |  변환: {td.get('conversions', 0)}  |  에러: {td.get('errors', 0)}  |  피크 동시: {td.get('peak_concurrent', 0)}")
+    hourly = td.get("hourly", {})
+    if hourly:
+        lines.append("")
+        lines.append("시간대별:")
+        for h in sorted(hourly.keys()):
+            hd = hourly[h]
+            err_str = f"  에러: {hd.get('errors',0):>3}" if hd.get('errors', 0) else ""
+            lines.append(f"  {h}시  방문: {hd.get('visits',0):>3}  변환: {hd.get('conversions',0):>3}{err_str}")
+
+    # Recent errors today
+    recent_errs = td.get("recent_errors", [])
+    if recent_errs:
+        lines.append("")
+        lines.append("최근 에러:")
+        for e in recent_errs[-5:]:
+            lines.append(f"  [{e.get('time','')}] {e.get('msg','')[:100]}")
+    lines.append("")
+
+    # Recent 7 days summary
+    lines.append("=== 최근 7일 ===")
+    lines.append(f"{'날짜':<12} {'방문':>5} {'변환':>5} {'에러':>4} {'피크':>4}")
+    lines.append("-" * 38)
+    dates = sorted(data.keys(), reverse=True)[:7]
+    total_v, total_c, total_e = 0, 0, 0
+    for d in dates:
+        dd = data[d]
+        v = dd.get("visits", 0)
+        c = dd.get("conversions", 0)
+        e = dd.get("errors", 0)
+        p = dd.get("peak_concurrent", 0)
+        total_v += v
+        total_c += c
+        total_e += e
+        lines.append(f"{d:<12} {v:>5} {c:>5} {e:>4} {p:>4}")
+    lines.append("-" * 38)
+    lines.append(f"{'합계':<12} {total_v:>5} {total_c:>5} {total_e:>4}")
+
+    return "\n".join(lines)
+
+_PREPROCESS_MAP = {"없음": "none", "Otsu": "otsu", "Adaptive": "adaptive", "대비강화": "contrast"}
+_UPSCALE_MAP = {
+    "없음": "none",
+    "PIL 2×": "pil_2", "PIL 3×": "pil_3",
+}
+
+
+def _extract_mml_parts(text: str) -> List[str]:
+    """Extract MML content from MML@...;  patterns."""
+    matches = re.findall(r'MML@([^;]*);', text, re.IGNORECASE)
+    return matches
+
+
+def _to_mabi_tracks(text: str) -> List[str]:
+    """Convert Part-labeled MML text to MabiIcco track strings.
+
+    Mabinogi: 1 track = max 3 channels (melody, chord, bass).
+    N parts → ceil(N/3) tracks, each: MML@ch1,ch2,ch3;
+    Empty channels filled with empty string: MML@p7,,;
+    """
+    parts = _extract_mml_parts(text)
+    if not parts:
+        return []
+    tracks = []
+    for i in range(0, len(parts), 3):
+        chunk = parts[i:i + 3]
+        while len(chunk) < 3:
+            chunk.append("")
+        tracks.append("MML@" + ",".join(chunk) + ";")
+    return tracks
+
+
+def _make_track_files(text: str, prefix: str, ts: str, tmpdir: Path) -> List[str]:
+    """Generate one .mml file per track, return list of file paths."""
+    tracks = _to_mabi_tracks(text)
+    if not tracks:
+        return []
+    paths = []
+    for i, track in enumerate(tracks, 1):
+        p = tmpdir / f"{prefix}_track{i}_{ts}.mml"
+        p.write_text(track, encoding="utf-8")
+        paths.append(str(p))
+    return paths
+
+
+_MABI_CHAR_LIMIT = 1500  # 마비노기 MML 채널당 글자수 제한 (근사값)
+
+
+def _mml_char_info(text: str, label: str) -> str:
+    """Generate per-part character count summary. Warns if over limit."""
+    parts = _extract_mml_parts(text)
+    if not parts:
+        return ""
+    lines = [f"[{label} 글자수]"]
+    for i, p in enumerate(parts, 1):
+        full = f"MML@{p};"
+        n = len(full)
+        warn = f" *** {_MABI_CHAR_LIMIT}자 초과!" if n > _MABI_CHAR_LIMIT else ""
+        lines.append(f"  Part {i}: {n}자{warn}")
+    return "\n".join(lines)
+
+
+def _check_pdf_pages(file_path: str) -> str | None:
+    if Path(file_path).suffix.lower() != ".pdf":
+        return None
+    try:
+        import fitz
+        doc = fitz.open(file_path)
+        count = doc.page_count
+        doc.close()
+        if count > MAX_PDF_PAGES:
+            return f"PDF가 {count}페이지입니다. 최대 {MAX_PDF_PAGES}페이지까지 지원합니다."
+    except Exception:
+        pass
+    return None
+
+
+def convert(file_path, preprocess, dpi_str, upscale, page_start, page_end, progress=gr.Progress()):
+    global _active_count
+    empty = ("", "", [], [], [], [], [], "")
+    if file_path is None:
+        return (*empty[:7], "파일을 업로드해주세요.")
+
+    ext = Path(file_path).suffix.lower()
+    if ext not in SUPPORTED_EXTENSIONS:
+        return (*empty[:7], f"지원하지 않는 파일 형식입니다: {ext}\n지원 형식: PDF, PNG, JPG")
+
+    page_err = _check_pdf_pages(file_path)
+    ps = int(page_start) if page_start else 0
+    pe = int(page_end) if page_end else 0
+    if page_err and ps == 0 and pe == 0:
+        return (*empty[:7], page_err)
+
+    dpi = int(dpi_str) if dpi_str else 300
+
+    # Use a persistent work_dir so we can retrieve page PNGs for preview
+    work_dir = tempfile.mkdtemp(prefix="sml_ui_")
+
+    with _active_lock:
+        _active_count += 1
+    try:
+        combined, mxl_paths, xml_paths, warnings = run_score_pipeline(
+            input_path=file_path,
+            preprocess_mode=_PREPROCESS_MAP.get(preprocess, "none"),
+            dpi=dpi,
+            upscale_mode=_UPSCALE_MAP.get(upscale, "none"),
+            on_progress=lambda frac, desc: progress(frac, desc=desc),
+            correct_xml=False,
+            save_dir=work_dir,
+            page_start=ps,
+            page_end=pe,
+        )
+    except Exception as e:
+        with _active_lock:
+            _active_count -= 1
+        _record_error(str(e))
+        return (*empty[:7], f"변환 중 오류 발생:\n{e}")
+
+    with _active_lock:
+        _active_count -= 1
+
+    # Collect page preview images from work_dir/pages/
+    pages_dir = Path(work_dir) / "pages"
+    preview_images = sorted(pages_dir.glob("*.png")) if pages_dir.exists() else []
+    # Filter: show preprocessed versions if they exist, otherwise originals
+    pre_imgs = [p for p in preview_images if "_pre" in p.name or "_norm" in p.name]
+    if not pre_imgs:
+        pre_imgs = [p for p in preview_images if not p.name.endswith(("_norm.png",))]
+    # Convert to string paths for gr.Gallery
+    preview_paths = [str(p) for p in (pre_imgs if pre_imgs else preview_images)]
+
+    # Split combined into Whole Part and 3 Part
+    if _SEP in combined:
+        parts = combined.split(_SEP, 1)
+        whole_text = parts[0].strip()
+        three_text = parts[1].strip()
+    else:
+        whole_text = combined.strip()
+        three_text = ""
+
+    # Generate MabiIcco-compatible MML files (1 file per track)
+    stem = Path(file_path).stem
+    ts = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+    tmpdir = Path(tempfile.gettempdir())
+
+    whole_files = _make_track_files(whole_text, f"{stem}_whole", ts, tmpdir)
+    three_files = _make_track_files(three_text, f"{stem}_3part", ts, tmpdir) if three_text else []
+
+    _record_conversion()
+
+    # Build warnings + char count info
+    info_parts = []
+    if warnings:
+        info_parts.append("\n".join(f"[WARN] {w}" for w in warnings))
+    else:
+        info_parts.append("경고 없음")
+    whole_info = _mml_char_info(whole_text, "Whole Part")
+    three_info = _mml_char_info(three_text, "3 Part")
+    if whole_info:
+        info_parts.append(whole_info)
+    if three_info:
+        info_parts.append(three_info)
+    warnings_text = "\n\n".join(info_parts)
+
+    return (
+        whole_text,
+        three_text,
+        whole_files,
+        three_files,
+        mxl_paths,
+        xml_paths,
+        preview_paths,
+        warnings_text,
+    )
+
+
+def _apply_tempo(whole_text: str, three_text: str, tempo: int):
+    """각 MML@...; 파트의 템포를 T{tempo}로 교체/삽입하고 다운로드 파일 재생성."""
+    tempo = max(32, min(255, int(tempo)))
+
+    def replace_tempo(text):
+        if not text:
+            return text
+        # MML@T120... → MML@T{tempo}... or MML@c4... → MML@T{tempo}c4...
+        return re.sub(r'(MML@)(T\d+)?', rf'\1T{tempo}', text, flags=re.IGNORECASE)
+
+    new_whole = replace_tempo(whole_text)
+    new_three = replace_tempo(three_text)
+
+    # Regenerate download files (1 per track)
+    ts = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+    tmpdir = Path(tempfile.gettempdir())
+
+    whole_files = _make_track_files(new_whole, f"tempo{tempo}_whole", ts, tmpdir) if new_whole else []
+    three_files = _make_track_files(new_three, f"tempo{tempo}_3part", ts, tmpdir) if new_three else []
+
+    return (
+        new_whole,
+        new_three,
+        whole_files,
+        three_files,
+    )
+
+
+# ---------------------------------------------------------------------------
+# MML Player JS — gr.Button.click(fn=None, js="() => {...}") is the only
+# reliable way to execute JS in Gradio (innerHTML/head/js all fail).
+# ---------------------------------------------------------------------------
+
+_JS_INIT = """
+if(!window._MP){
+  window._MP={actx:null,playing:[],stop:false};
+  window._MP.parse=function(mml){
+    var notes=[],tempo=120,oct=4,dL=4,vol=8,i=0;
+    var s=mml.toUpperCase().replace(/\\s+/g,'');
+    var nm={C:0,D:2,E:4,F:5,G:7,A:9,B:11};
+    function rn(){var n='';while(i<s.length&&s[i]>='0'&&s[i]<='9'){n+=s[i];i++;}return n?parseInt(n):0;}
+    function ls(l){var b=60/tempo*4/l,d=0;while(i<s.length&&s[i]==='.'){d++;i++;}var x=b;for(var j=0;j<d;j++){x/=2;b+=x;}return b;}
+    while(i<s.length){
+      var c=s[i];
+      if(c==='T'){i++;tempo=rn()||120;}
+      else if(c==='O'){i++;oct=rn()||4;}
+      else if(c==='L'){i++;dL=rn()||4;}
+      else if(c==='V'){i++;vol=rn();if(vol>15)vol=15;}
+      else if(c==='>'){i++;oct=Math.min(oct+1,8);}
+      else if(c==='<'){i++;oct=Math.max(oct-1,1);}
+      else if(c==='&'){i++;}
+      else if(c==='N'){i++;var nn=rn();var ll=rn()||dL;notes.push({m:nn,d:ls(ll),v:vol});}
+      else if(nm[c]!==undefined){
+        i++;var sm=nm[c];
+        if(i<s.length&&s[i]==='+'){sm++;i++;}
+        else if(i<s.length&&(s[i]==='-'||s[i]==='#')){if(s[i]==='#')sm++;else sm--;i++;}
+        var ll2=rn()||dL;var dur=ls(ll2);notes.push({m:(oct+1)*12+sm,d:dur,v:vol});
+      }
+      else if(c==='R'){i++;var ll3=rn()||dL;notes.push({m:-1,d:ls(ll3),v:0});}
+      else{i++;}
+    }
+    return notes;
+  };
+  window._MP.freq=function(m){return 440*Math.pow(2,(m-69)/12);};
+  window._MP.playN=function(nl){
+    var P=window._MP;
+    if(!P.actx)P.actx=new(window.AudioContext||window.webkitAudioContext)();
+    if(P.actx.state==='suspended')P.actx.resume();
+    var t=P.actx.currentTime+0.05;
+    for(var i=0;i<nl.length;i++){
+      var n=nl[i];if(P.stop)break;if(n.m<0){t+=n.d;continue;}
+      var o=P.actx.createOscillator(),g=P.actx.createGain(),v=n.v/15*0.3;
+      o.type='triangle';o.frequency.value=P.freq(n.m);
+      g.gain.setValueAtTime(v,t);g.gain.exponentialRampToValueAtTime(0.001,t+n.d*0.95);
+      o.connect(g);g.connect(P.actx.destination);o.start(t);o.stop(t+n.d);
+      P.playing.push(o);t+=n.d;
+    }
+    return t-P.actx.currentTime;
+  };
+  window._MP.getFrom=function(elemId){
+    var box=document.getElementById(elemId);
+    if(box){var ta=box.querySelector('textarea');if(ta&&ta.value)return ta.value.trim();}
+    return '';
+  };
+  window._MP.extract=function(t){var m=t.match(/MML@[^;]*;/gi)||[];return m.map(function(s){return s.replace(/^MML@/i,'').replace(/;$/,'');});};
+  window._MP.doStop=function(){
+    var P=window._MP;P.stop=true;
+    P.playing.forEach(function(o){try{o.stop();}catch(e){}});P.playing=[];
+  };
+  window._MP.go=function(mmlArr,label){
+    var P=window._MP;P.doStop();P.stop=false;
+    if(!mmlArr.length){alert('재생할 MML이 없습니다');return;}
+    var total=0,maxD=0;
+    for(var i=0;i<mmlArr.length;i++){
+      var notes=P.parse(mmlArr[i]);total+=notes.length;
+      var d=P.playN(notes);if(d>maxD)maxD=d;
+    }
+    if(total===0){alert('파싱된 노트가 없습니다');return;}
+    alert(label+' 재생 시작 ('+total+'개 노트, '+mmlArr.length+'트랙)');
+  };
+}
+"""
+
+
+def _make_box_play_js(elem_id: str, label: str, part_index: int | None = None) -> str:
+    """Play all MML parts from a specific textbox, or a single part by index."""
+    if part_index is not None:
+        action = (
+            f"var parts=P.extract(text);"
+            f"if(parts.length>{part_index})P.go([parts[{part_index}]],'{label}');"
+            f"else alert('{label} 파트를 찾을 수 없습니다');"
+        )
+    else:
+        action = f"var parts=P.extract(text);P.go(parts,'{label}');"
+    return "() => {" + _JS_INIT + f"""
+var P=window._MP;
+var text=P.getFrom('{elem_id}');
+if(!text){{alert('MML 결과가 없습니다. 먼저 악보를 변환하세요.');}}
+else{{{action}}}
+}}"""
+
+
+_JS_STOP = "() => {" + _JS_INIT + "window._MP.doStop();alert('정지');}"
+
+_JS_TEST = "() => {" + _JS_INIT + """
+var P=window._MP;P.doStop();P.stop=false;
+var mml='T120O5G8E8E4F8D8D4C8D8E8F8G4G4G8E8E8E8F8D8D8D8C8E8G8G8E2';
+var notes=P.parse(mml);
+P.playN(notes);
+alert('나비야 테스트 재생 ('+notes.length+'개 노트)');
+}"""
+
+
+def build_ui() -> gr.Blocks:
+    with gr.Blocks(title="악보 → MML 변환기") as demo:
+        gr.Markdown("# 악보 → MML 변환기")
+        gr.Markdown("PDF 또는 이미지 악보를 업로드하면 마비노기 MML로 변환해드립니다.")
+
+        with gr.Row():
+            with gr.Column():
+                file_input = gr.File(
+                    label="악보 파일 (PDF, PNG, JPG)",
+                    file_types=[".pdf", ".png", ".jpg", ".jpeg"],
+                )
+                preprocess_radio = gr.Radio(
+                    choices=["없음", "Otsu", "Adaptive", "대비강화"],
+                    value="없음",
+                    label="전처리 (없음=원본, Otsu=깨끗한스캔, Adaptive=조명불균일, 대비강화=흐린스캔)",
+                )
+                dpi = gr.Dropdown(
+                    choices=["150", "300", "450", "600"],
+                    value="300",
+                    label="DPI (PDF만 해당, 300 권장)",
+                )
+                upscale_radio = gr.Radio(
+                    choices=["없음", "PIL 2×", "PIL 3×"],
+                    value="없음",
+                    label="업스케일 (PIL 리사이즈 — 저해상도 스캔에 효과적)",
+                )
+                with gr.Row():
+                    page_start_input = gr.Number(
+                        value=0, label="시작 페이지 (0=처음부터)", minimum=0, precision=0,
+                    )
+                    page_end_input = gr.Number(
+                        value=0, label="끝 페이지 (0=끝까지)", minimum=0, precision=0,
+                    )
+                convert_btn = gr.Button("변환 시작", variant="primary")
+
+            with gr.Column():
+                # 입력 이미지 미리보기
+                preview_gallery = gr.Gallery(
+                    label="입력 악보 미리보기",
+                    columns=2,
+                    height=200,
+                    object_fit="contain",
+                )
+
+                # Whole Part (N파트 전체화음)
+                gr.Markdown("#### Whole Part (전체화음)")
+                whole_output = gr.Textbox(
+                    label="전체화음 N파트 MML",
+                    lines=12,
+                    placeholder="전체화음 결과",
+                    elem_id="mml-whole",
+                )
+                whole_file = gr.File(label="Whole Part 다운로드 (트랙별 파일)", file_count="multiple")
+                with gr.Row():
+                    whole_play_btn = gr.Button("▶ Whole Part 재생", variant="primary", size="sm")
+                    stop_btn = gr.Button("■ 정지", size="sm")
+
+                # 3 Part (멜로디/화음/베이스)
+                gr.Markdown("#### 3 Part (멜로디 / 화음 / 베이스)")
+                three_output = gr.Textbox(
+                    label="3파트 MML (Part1=멜로디, Part2=화음, Part3=베이스)",
+                    lines=12,
+                    placeholder="3파트 결과",
+                    elem_id="mml-three",
+                )
+                three_file = gr.File(label="3 Part 다운로드 (트랙별 파일)", file_count="multiple")
+                with gr.Row():
+                    three_play_btn = gr.Button("▶ 3 Part 전체", size="sm")
+                    melody_btn = gr.Button("▶ 멜로디", size="sm")
+                    chord_btn = gr.Button("▶ 화음", size="sm")
+                    bass_btn = gr.Button("▶ 베이스", size="sm")
+
+                # 박자 (Tempo) 조절
+                gr.Markdown("#### 박자 조절")
+                with gr.Row():
+                    tempo_slider = gr.Slider(
+                        minimum=32, maximum=255, value=120, step=1,
+                        label="Tempo (32~255, 기본: 120)",
+                        elem_id="tempo-slider",
+                    )
+                    tempo_btn = gr.Button("박자 적용", size="sm")
+
+                # 기타 다운로드
+                mxl_output = gr.File(label="MXL 다운로드", file_count="multiple")
+                xml_output = gr.File(label="XML 다운로드", file_count="multiple")
+                warnings_output = gr.Textbox(label="경고", lines=3, placeholder="경고 메시지")
+
+        # 테스트
+        with gr.Row():
+            test_btn = gr.Button("나비야 테스트", size="sm")
+
+        # Admin dashboard
+        with gr.Accordion("통계 대시보드", open=False):
+            dashboard_output = gr.Textbox(
+                label="서버 통계",
+                lines=20,
+                interactive=False,
+                elem_id="dashboard",
+            )
+            refresh_btn = gr.Button("새로고침", size="sm")
+            refresh_btn.click(fn=_get_dashboard, outputs=[dashboard_output])
+
+        # Wire up playback JS
+        stop_btn.click(fn=None, js=_JS_STOP)
+        whole_play_btn.click(fn=None, js=_make_box_play_js("mml-whole", "Whole Part"))
+        three_play_btn.click(fn=None, js=_make_box_play_js("mml-three", "3 Part"))
+        melody_btn.click(fn=None, js=_make_box_play_js("mml-three", "멜로디", 0))
+        chord_btn.click(fn=None, js=_make_box_play_js("mml-three", "화음", 1))
+        bass_btn.click(fn=None, js=_make_box_play_js("mml-three", "베이스", 2))
+        test_btn.click(fn=None, js=_JS_TEST)
+
+        # Wire up tempo
+        tempo_btn.click(
+            fn=_apply_tempo,
+            inputs=[whole_output, three_output, tempo_slider],
+            outputs=[whole_output, three_output, whole_file, three_file],
+        )
+
+        # Wire up conversion
+        convert_btn.click(
+            fn=convert,
+            inputs=[file_input, preprocess_radio, dpi, upscale_radio, page_start_input, page_end_input],
+            outputs=[whole_output, three_output, whole_file, three_file,
+                     mxl_output, xml_output, preview_gallery, warnings_output],
+        )
+
+        # Record page visit
+        demo.load(fn=_record_visit)
+
+    return demo
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--share", action="store_true", help="외부 공유 링크 생성")
+    parser.add_argument("--port", type=int, default=7860, help="포트 번호 (기본: 7860)")
+    args = parser.parse_args()
+
+    demo = build_ui()
+    demo.queue(max_size=10, default_concurrency_limit=1)
+    demo.launch(
+        share=args.share,
+        server_name="0.0.0.0",
+        server_port=args.port,
+    )