Update app.py

app.py

@@ -1,210 +1,307 @@
-import io, os, zipfile, re
-import streamlit as st
-import pandas as pd
-from reportlab.pdfgen import canvas
-from reportlab.lib.pagesizes import A4
-from reportlab.lib.units import mm
-
-def replace_placeholders_in_hwpx(hwpx_bytes: bytes, mapping: dict) -> bytes:
-    mem_in = io.BytesIO(hwpx_bytes)
-    mem_out = io.BytesIO()
-    zin = zipfile.ZipFile(mem_in, "r")
-    zout = zipfile.ZipFile(mem_out, "w", zipfile.ZIP_DEFLATED)
-    alias = {
-        "box2": "박스번호2","year2": "종료연도2","duration2": "보존기간2","task2": "단위업무2","file2": "기록물철2","list2": "목록2",
-        "box3": "박스번호3","year3": "종료연도3","duration3": "보존기간3","task3": "단위업무3","file3": "기록물철3","list3": "목록3",
-    }
-    expanded_map = dict(mapping)
-    for k, v in list(mapping.items()):
-        for a, tgt in alias.items():
-            if k == tgt and a not in expanded_map:
-                expanded_map[a] = v
-    def repl_xml(txt: str, kv: dict) -> str:
-        any_token = any(("{{"+k+"}}" in txt) for k in kv.keys())
-        if any_token:
-            for k, v in kv.items():
-                txt = txt.replace(f"{{{{{k}}}}}", "" if v is None else str(v))
-            return txt
-        for k, v in kv.items():
-            pattern = re.compile(rf'(<hp:fieldBegin[^>]*name="{re.escape(k)}"[^>]*>.*?</hp:fieldBegin>)(.*?)(<hp:fieldEnd[^>]*/>)', re.DOTALL)
-            def _repl(m):
-                val = "" if v is None else str(v)
-                return f'{m.group(1)}<hp:run><hp:t>{val}</hp:t></hp:run>{m.group(3)}'
-            txt, _ = pattern.subn(_repl, txt, count=20)
-        return txt
-    for item in zin.infolist():
-        data = zin.read(item.filename)
-        if item.filename.startswith("Contents/") and item.filename.endswith(".xml"):
-            try:
-                txt = data.decode("utf-8", errors="ignore")
-                txt = repl_xml(txt, expanded_map)
-                data = txt.encode("utf-8")
-            except Exception:
-                pass
-        zout.writestr(item, data)
-    zin.close()
-    zout.close()
-    mem_out.seek(0)
-    return mem_out.getvalue()
-
-LABEL_W, LABEL_H = 89*mm, 38*mm
-MARGIN_L, MARGIN_T = 10*mm, 10*mm
-COL_GAP, ROW_GAP = 5*mm, 5*mm
-COLS, ROWS = 2, 5
-
-def draw_label(c, x, y, row_dict):
-    c.setFont("Helvetica", 9)
-    lines = [
-        f"박스번호: {row_dict.get('박스번호','')}",
-        f"종료연도(범위): {row_dict.get('생산연도','')}",
-        f"보존기간: {row_dict.get('보존기간','')}",
-        f"단위업무: {row_dict.get('단위업무','')}",
-        f"기록물철: {row_dict.get('기록물철','')}",
-        f"목록(요약): {str(row_dict.get('목록',''))[:40]}",
-    ]
-    ty = y + LABEL_H - 8*mm
-    for ln in lines:
-        c.drawString(x + 5*mm, ty, ln)
-        ty -= 5*mm
-    c.rect(x, y, LABEL_W, LABEL_H)
-
-def make_preview_pdf(rows: list) -> bytes:
-    buf = io.BytesIO()
-    c = canvas.Canvas(buf, pagesize=A4)
-    page_i, i = 0, 0
-    while i < len(rows):
-        c.setFont("Helvetica-Bold", 10)
-        c.drawString(15*mm, 287*mm, f"Formtec 3203 Preview — Page {page_i+1}")
-        for r in range(ROWS):
-            for col in range(COLS):
-                if i >= len(rows): break
-                x = MARGIN_L + col*(LABEL_W + COL_GAP)
-                y = (A4[1] - MARGIN_T - LABEL_H) - r*(LABEL_H + ROW_GAP)
-                draw_label(c, x, y, rows[i])
-                i += 1
-        c.showPage()
-        page_i += 1
-    c.save()
-    buf.seek(0)
-    return buf.read()
-
-def compute_year_range(series: pd.Series):
-    s = series.astype(str).fillna("")
-    valid = s[~s.isin(["", "0", "0000"])]
-    if len(valid) == 0:
-        return "0000-0000"
-    valid_int = pd.to_numeric(valid, errors="coerce").dropna().astype(int)
-    if len(valid_int) == 0:
-        return "0000-0000"
-    return f"{valid_int.min():04d}-{valid_int.max():04d}"
-
-def build_merged_df(df: pd.DataFrame) -> pd.DataFrame:
-    df = df.copy()
-    if "제목" in df.columns:
-        df["제목"] = df["제목"].astype(str)
-    if "박스번호" in df.columns:
-        df["박스번호"] = df["박스번호"].astype(str).str.zfill(4)
-    if "종료연도" in df.columns:
-        prod_df = df.groupby("박스번호")["종료연도"].apply(compute_year_range).reset_index()
-        prod_df.columns = ["박스번호", "생산연도"]
-    else:
-        prod_df = pd.DataFrame({"박스번호": df["박스번호"].unique(), "생산연도": "0000-0000"})
-    has_mgmt = "관리번호" in df.columns
-    list_data = []
-    for box_num, group in df.groupby("박스번호"):
-        if has_mgmt:
-            lines = [f"- {row['관리번호']} {row['제목']}" for _, row in group.iterrows()]
-        else:
-            lines = [f"- {row['제목']}" for _, row in group.iterrows()]
-        list_data.append({"박스번호": box_num, "목록": "\r\n".join(lines)})
-    list_df = pd.DataFrame(list_data)
-    meta_cols = ["박스번호","종료연도","보존기간","단위업무","기록물철","제목"]
-    meta_exist = [c for c in meta_cols if c in df.columns]
-    meta_df = df.groupby("박스번호", as_index=False).first()[meta_exist]
-    merged = meta_df.merge(list_df, on="박스번호").merge(prod_df, on="박스번호")
-    return merged
-
-st.set_page_config(page_title="박스라벨(.HWPX) 생성기 — Hugging Face", layout="wide")
-st.title("📦 박스라벨 자동 생성기 (.HWPX 템플릿)")
-
-with st.expander("사용 방법", expanded=True):
-    st.markdown("""
-`.hwpx` 템플릿을 업로드하고, 엑셀/CSV 데이터를 연결해 라벨을 생성합니다. 템플릿에는 `박스번호·종료연도·보존기간·단위업무·기록물철·목록` 필드가 세트별로 존재해야 합니다(예: 1~3세트).
-""")
-
-tpl_file = st.file_uploader("HWPX 템플릿 업로드", type=["hwpx"])
-data_file = st.file_uploader("데이터 업로드 (Excel/CSV)", type=["xlsx","xls","csv"])
-batch_size = st.number_input("템플릿의 라벨 세트 개수", min_value=1, max_value=12, value=3, step=1)
-preview_pdf = st.checkbox("PDF 미리보기도 생성", value=False)
-
-default_fields = ["박스번호","종료연도","보존기간","단위업무","기록물철","목록"]
-
-if data_file:
-    if data_file.name.lower().endswith(".csv"):
-        df = pd.read_csv(data_file)
-    else:
-        df = pd.read_excel(data_file)
-    st.write("데이터 미리보기")
-    st.dataframe(df.head(10), use_container_width=True)
-    st.subheader("컬럼 매핑 (엑셀/CSV → 라벨 필드)")
-    col_map = {}
-    for f in ["박스번호","종료연도","보존기간","단위업무","기록물철","관리번호","제목"]:
-        options = ["(없음)"] + list(df.columns)
-        default_idx = options.index(f) if f in df.columns else 0
-        col_map[f] = st.selectbox(f"{f} →", options, index=default_idx, key=f"map_{f}")
-    renames = {v: k for k, v in col_map.items() if v != "(없음)"}
-    df_std = df.rename(columns=renames)
-    if "박스번호" not in df_std.columns:
-        st.error("필수 컬럼 '박스번호'가 매핑되지 않았습니다.")
-    else:
-        merged_df = build_merged_df(df_std)
-        st.text_input("출력할 박스번호 (쉼표 구분, 비우면 전체)", key="sel_boxes")
-        run = st.button("라벨 생성 (HWPX ZIP)")
-        if run:
-            if not tpl_file:
-                st.error("템플릿(.hwpx)을 업로드해 주세요.")
-            else:
-                tpl_bytes = tpl_file.read()
-                user_input = st.session_state.get("sel_boxes", "").strip()
-                work_df = merged_df.copy()
-                if user_input:
-                    targets = [s.strip().zfill(4) for s in user_input.split(",") if s.strip()]
-                    work_df = work_df[work_df["박스번호"].isin(targets)]
-                if len(work_df) == 0:
-                    st.warning("조건에 해당하는 박스번호가 없습니다.")
-                else:
-                    rows = work_df.to_dict(orient="records")
-                    zip_buf = io.BytesIO()
-                    with zipfile.ZipFile(zip_buf, "w", zipfile.ZIP_DEFLATED) as zout:
-                        num_boxes = len(rows)
-                        num_pages = (num_boxes + batch_size - 1) // batch_size
-                        for i in range(num_pages):
-                            mapping_all = {}
-                            page_rows = []
-                            for j in range(batch_size):
-                                idx = i * batch_size + j
-                                if idx >= num_boxes:
-                                    for prefix in default_fields:
-                                        mapping_all[f"{prefix}{j+1}"] = ""
-                                    continue
-                                r = rows[idx]
-                                page_rows.append(r)
-                                for prefix in default_fields:
-                                    if prefix == "종료연도":
-                                        mapping_all[f"{prefix}{j+1}"] = r.get("생산연도","")
-                                    else:
-                                        mapping_all[f"{prefix}{j+1}"] = r.get(prefix,"")
-                            out_hwpx = replace_placeholders_in_hwpx(tpl_bytes, mapping_all)
-                            page_nums = [str(x.get("박스번호","")) for x in page_rows]
-                            safe_name = "_".join(page_nums) if page_nums else f"empty_{i+1}"
-                            zout.writestr(f"label_{safe_name}.hwpx", out_hwpx)
-                    zip_buf.seek(0)
-                    st.download_button("📥 HWPX 일괄 다운로드 (ZIP)", data=zip_buf, file_name="boxlabels_hwpx.zip", mime="application/zip")
-                    if preview_pdf:
-                        try:
-                            pdf_bytes = make_preview_pdf(rows)
-                            st.download_button("👀 PDF 미리보기 다운로드", data=pdf_bytes, file_name="preview.pdf", mime="application/pdf")
-                        except Exception as e:
-                            st.warning(f"PDF 미리보기 생성 실패: {e}")
-
-st.caption("※ 템플릿은 반드시 .HWPX 파일이어야 합니다. 한글에서 '다른 이름으로 저장' → HWPX.")
+import io, os, zipfile, re
+import streamlit as st
+import pandas as pd
+
+# (선택) PDF 미리보기용
+from reportlab.pdfgen import canvas
+from reportlab.lib.pagesizes import A4
+from reportlab.lib.units import mm
+
+# =========================
+# HWPX 템플릿 치환 유틸 (필드컨트롤 & {{토큰}} 지원)
+# =========================
+def replace_placeholders_in_hwpx(hwpx_bytes: bytes, mapping: dict) -> bytes:
+    mem_in = io.BytesIO(hwpx_bytes)
+    mem_out = io.BytesIO()
+    zin = zipfile.ZipFile(mem_in, "r")
+    zout = zipfile.ZipFile(mem_out, "w", zipfile.ZIP_DEFLATED)
+
+    # 템플릿에 있는 영문 별칭 → 한글 필드 동시 주입
+    alias = {
+        # 세트2
+        "box2": "박스번호2","year2": "종료연도2","duration2": "보존기간2","task2": "단위업무2","file2": "기록물철2","list2": "목록2",
+        # 세트3
+        "box3": "박스번호3","year3": "종료연도3","duration3": "보존기간3","task3": "단위업무3","file3": "기록물철3","list3": "목록3",
+    }
+    expanded_map = dict(mapping)
+    for k, v in list(mapping.items()):
+        for a, tgt in alias.items():
+            if k == tgt and a not in expanded_map:
+                expanded_map[a] = v
+
+    def repl_xml(txt: str, kv: dict) -> str:
+        # 1) {{키}} 치환
+        any_token = any(("{{"+k+"}}" in txt) for k in kv.keys())
+        if any_token:
+            for k, v in kv.items():
+                txt = txt.replace(f"{{{{{k}}}}}", "" if v is None else str(v))
+            return txt
+        # 2) 필드컨트롤 본문 치환
+        for k, v in kv.items():
+            pattern = re.compile(
+                rf'(<hp:fieldBegin[^>]*name="{re.escape(k)}"[^>]*>.*?</hp:fieldBegin>)(.*?)(<hp:fieldEnd[^>]*/>)',
+                re.DOTALL
+            )
+            def _repl(m):
+                val = "" if v is None else str(v)
+                return f'{m.group(1)}<hp:run><hp:t>{val}</hp:t></hp:run>{m.group(3)}'
+            txt, _ = pattern.subn(_repl, txt, count=50)
+        return txt
+
+    for item in zin.infolist():
+        data = zin.read(item.filename)
+        if item.filename.startswith("Contents/") and item.filename.endswith(".xml"):
+            try:
+                txt = data.decode("utf-8", errors="ignore")
+                txt = repl_xml(txt, expanded_map)
+                data = txt.encode("utf-8")
+            except Exception:
+                pass
+        zout.writestr(item, data)
+
+    zin.close()
+    zout.close()
+    mem_out.seek(0)
+    return mem_out.getvalue()
+
+# =========================
+# PDF 미리보기 (폼텍 3203 예시)
+# =========================
+LABEL_W, LABEL_H = 89*mm, 38*mm
+MARGIN_L, MARGIN_T = 10*mm, 10*mm
+COL_GAP, ROW_GAP = 5*mm, 5*mm
+COLS, ROWS = 2, 5
+
+def draw_label(c, x, y, row_dict):
+    c.setFont("Helvetica", 9)
+    lines = [
+        f"박스번호: {row_dict.get('박스번호','')}",
+        f"종료연도(범위): {row_dict.get('생산연도','')}",
+        f"보존기간: {row_dict.get('보존기간','')}",
+        f"단위업무: {row_dict.get('단위업무','')}",
+        f"기록물철: {row_dict.get('기록물철','')}",
+        f"목록(요약): {str(row_dict.get('목록',''))[:40]}",
+    ]
+    ty = y + LABEL_H - 8*mm
+    for ln in lines:
+        c.drawString(x + 5*mm, ty, ln)
+        ty -= 5*mm
+    c.rect(x, y, LABEL_W, LABEL_H)
+
+def make_preview_pdf(rows: list) -> bytes:
+    buf = io.BytesIO()
+    c = canvas.Canvas(buf, pagesize=A4)
+    page_i, i = 0, 0
+    while i < len(rows):
+        c.setFont("Helvetica-Bold", 10)
+        c.drawString(15*mm, 287*mm, f"Formtec 3203 Preview — Page {page_i+1}")
+        for r in range(ROWS):
+            for col in range(COLS):
+                if i >= len(rows): break
+                x = MARGIN_L + col*(LABEL_W + COL_GAP)
+                y = (A4[1] - MARGIN_T - LABEL_H) - r*(LABEL_H + ROW_GAP)
+                draw_label(c, x, y, rows[i])
+                i += 1
+        c.showPage()
+        page_i += 1
+    c.save()
+    buf.seek(0)
+    return buf.read()
+
+# =========================
+# 업로드 모드: 엑셀 데이터 병합 로직
+# =========================
+def compute_year_range(series: pd.Series):
+    s = series.astype(str).fillna("")
+    valid = s[~s.isin(["", "0", "0000"])]
+    if len(valid) == 0:
+        return "0000-0000"
+    valid_int = pd.to_numeric(valid, errors="coerce").dropna().astype(int)
+    if len(valid_int) == 0:
+        return "0000-0000"
+    return f"{valid_int.min():04d}-{valid_int.max():04d}"
+
+def build_merged_df(df: pd.DataFrame) -> pd.DataFrame:
+    df = df.copy()
+    if "제��" in df.columns:
+        df["제목"] = df["제목"].astype(str)
+    if "박스번호" in df.columns:
+        df["박스번호"] = df["박스번호"].astype(str).str.zfill(4)
+
+    # 생산연도(범위) 계산
+    if "종료연도" in df.columns:
+        prod_df = df.groupby("박스번호")["종료연도"].apply(compute_year_range).reset_index()
+        prod_df.columns = ["박스번호", "생산연도"]
+    else:
+        prod_df = pd.DataFrame({"박스번호": df["박스번호"].unique(), "생산연도": "0000-0000"})
+
+    # 목록(관리번호 + 제목)
+    has_mgmt = "관리번호" in df.columns
+    list_data = []
+    for box_num, group in df.groupby("박스번호"):
+        if has_mgmt:
+            lines = [f"- {row['관리번호']} {row['제목']}" for _, row in group.iterrows()]
+        else:
+            lines = [f"- {row['제목']}" for _, row in group.iterrows()]
+        list_data.append({"박스번호": box_num, "목록": "\r\n".join(lines)})
+    list_df = pd.DataFrame(list_data)
+
+    meta_cols = ["박스번호","종료연도","보존기간","단위업무","기록물철","제목"]
+    meta_exist = [c for c in meta_cols if c in df.columns]
+    meta_df = df.groupby("박스번호", as_index=False).first()[meta_exist]
+
+    merged = meta_df.merge(list_df, on="박스번호").merge(prod_df, on="박스번호")
+    return merged
+
+# =========================
+# Streamlit UI
+# =========================
+st.set_page_config(page_title="박스라벨(.HWPX) 생성기 — Hugging Face", layout="wide")
+st.title("📦 박스라벨 자동 생성기 (.HWPX 템플릿)")
+
+with st.expander("사용 방법", expanded=True):
+    st.markdown("""
+- **양식(.HWPX 템플릿)** 을 업로드합니다. (한글에서 '다른 이름으로 저장' → HWPX)
+- **데이터 입력 방식**을 선택합니다.  
+  1) **파일 업로드(엑셀/CSV)**: 기존 데이터로 일괄 생성  
+  2) **직접 입력(목록 & 메타데이터)**: 화면에서 박스별 정보를 수동으로 입력  
+- 템플릿에 세트별 필드(예: `박스번호1~3`, `종료연도1~3`, `보존기간1~3`, `단위업무1~3`, `기록물철1~3`, `목록1~3`)가 있어야 합니다.
+""")
+
+tpl_file = st.file_uploader("HWPX 템플릿 업로드", type=["hwpx"])
+batch_size = st.number_input("템플릿의 라벨 세트 개수", min_value=1, max_value=12, value=3, step=1)
+preview_pdf = st.checkbox("PDF 미리보기도 생성", value=False)
+
+mode = st.radio("데이터 입력 방식", ["파일 업로드(엑셀/CSV)", "직접 입력(목록 & 메타데이터)"], horizontal=True)
+default_fields = ["박스번호","종료연도","보존기간","단위업무","기록물철","목록"]
+
+rows = None  # 최종 생성에 사용할 row dict 리스트
+
+# ----- 모드 1: 파일 업로드 -----
+if mode == "파일 업로드(엑셀/CSV)":
+    data_file = st.file_uploader("데이터 업로드 (Excel/CSV)", type=["xlsx","xls","csv"])
+    if data_file:
+        if data_file.name.lower().endswith(".csv"):
+            df = pd.read_csv(data_file)
+        else:
+            df = pd.read_excel(data_file)
+        st.write("데이터 미리보기")
+        st.dataframe(df.head(10), use_container_width=True)
+
+        # 컬럼 매핑
+        st.subheader("컬럼 매핑 (엑셀/CSV → 라벨 필드)")
+        col_map = {}
+        for f in ["박스번호","종료연도","보존기간","단위업무","기록물철","관리번호","제목"]:
+            options = ["(없음)"] + list(df.columns)
+            default_idx = options.index(f) if f in df.columns else 0
+            col_map[f] = st.selectbox(f"{f} →", options, index=default_idx, key=f"map_{f}")
+        renames = {v: k for k, v in col_map.items() if v != "(없음)"}
+        df_std = df.rename(columns=renames)
+
+        if "박스번호" not in df_std.columns:
+            st.error("필수 컬럼 '박스번호'가 매핑되지 않았습니다.")
+        else:
+            merged_df = build_merged_df(df_std)
+            st.text_input("출력할 박스번호 (쉼표 구분, 비우면 전체)", key="sel_boxes")
+            if st.button("라벨 생성 (HWPX ZIP)", key="btn_upload"):
+                if not tpl_file:
+                    st.error("템플릿(.hwpx)을 업로드해 주세요.")
+                else:
+                    tpl_bytes = tpl_file.read()
+                    user_input = st.session_state.get("sel_boxes", "").strip()
+                    work_df = merged_df.copy()
+                    if user_input:
+                        targets = [s.strip().zfill(4) for s in user_input.split(",") if s.strip()]
+                        work_df = work_df[work_df["박스번호"].isin(targets)]
+                    if len(work_df) == 0:
+                        st.warning("조건에 해당하는 박스번호가 없습니다.")
+                    else:
+                        rows = work_df.to_dict(orient="records")
+
+# ----- 모드 2: 직접 입력 -----
+else:
+    st.info("박스별 정보를 직접 입력하세요. **목록**은 여러 줄로 입력하면 줄바꿈 유지됩니다.")
+    num_boxes = st.number_input("박스 개수", min_value=1, max_value=100, value=3, step=1)
+    manual_rows = []
+    for i in range(num_boxes):
+        st.subheader(f"박스 #{i+1}")
+        c1, c2, c3 = st.columns(3)
+        with c1:
+            box = st.text_input("박스번호 (숫자, 자동 4자리)", key=f"box_{i}")
+        with c2:
+            dur = st.text_input("보존기간", key=f"dur_{i}")
+        with c3:
+            task = st.text_input("단위업무", key=f"task_{i}")
+        c4, c5 = st.columns(2)
+        with c4:
+            folder = st.text_input("기록물철", key=f"file_{i}")
+        with c5:
+            prod = st.text_input("생산연도(범위) 예: 2019-2022", key=f"prod_{i}")
+        memo = st.text_area("목록 (한 줄당 한 항목, 앞에 '- '는 없어도 됩니다)", key=f"list_{i}", height=120,
+                            placeholder="예)\n2020-001 총무부 회의록\n2020-002 예산결산서\n...")
+
+        # 목록 정리: '- ' 접두 없으면 붙여줌, 빈 줄 제외
+        lines = [ln.strip() for ln in memo.splitlines() if ln.strip()]
+        norm_lines = [ln if ln.startswith("- ") else f"- {ln}" for ln in lines]
+        manual_rows.append({
+            "박스번호": (box or "").strip().zfill(4) if box else "",
+            "보존기간": dur.strip(),
+            "단위업무": task.strip(),
+            "기록물철": folder.strip(),
+            "생산연도": prod.strip(),
+            "목록": "\r\n".join(norm_lines)
+        })
+    if st.button("라벨 생성 (HWPX ZIP)", key="btn_manual"):
+        if not tpl_file:
+            st.error("템플릿(.hwpx)을 업로드해 주세요.")
+        else:
+            rows = manual_rows
+
+# ===== 실제 생성 공통 루틴 =====
+if rows is not None and len(rows) > 0:
+    tpl_bytes = tpl_file.read() if tpl_file else None
+    if not tpl_bytes:
+        st.error("템플릿(.hwpx)을 업로드해 주세요.")
+    else:
+        # ZIP으로 페이지 단위 HWPX 생성
+        default_fields = ["박스번호","종료연도","보존기간","단위업무","기록물철","목록"]
+        zip_buf = io.BytesIO()
+        with zipfile.ZipFile(zip_buf, "w", zipfile.ZIP_DEFLATED) as zout:
+            num_boxes = len(rows)
+            num_pages = (num_boxes + batch_size - 1) // batch_size
+            for i in range(num_pages):
+                mapping_all = {}
+                page_rows = []
+                for j in range(batch_size):
+                    idx = i * batch_size + j
+                    if idx >= num_boxes:
+                        # 남는 칸은 공백
+                        for prefix in default_fields:
+                            mapping_all[f"{prefix}{j+1}"] = ""
+                        continue
+                    r = rows[idx]
+                    page_rows.append(r)
+                    for prefix in default_fields:
+                        if prefix == "종료연도":
+                            # 템플릿의 "종료연도" 자리에는 '생산연도(범위)'를 넣는 설계
+                            mapping_all[f"{prefix}{j+1}"] = r.get("생산연도","")
+                        else:
+                            mapping_all[f"{prefix}{j+1}"] = r.get(prefix,"")
+                out_hwpx = replace_placeholders_in_hwpx(tpl_bytes, mapping_all)
+                page_nums = [str(x.get("박스번호","")) for x in page_rows]
+                safe_name = "_".join(page_nums) if page_nums else f"empty_{i+1}"
+                zout.writestr(f"label_{safe_name}.hwpx", out_hwpx)
+
+        zip_buf.seek(0)
+        st.download_button("📥 HWPX 일괄 다운로드 (ZIP)", data=zip_buf,
+                           file_name="boxlabels_hwpx.zip", mime="application/zip")
+
+        if preview_pdf:
+            try:
+                pdf_bytes = make_preview_pdf(rows)
+                st.download_button("👀 PDF 미리보기 다운로드", data=pdf_bytes,
+                                   file_name="preview.pdf", mime="application/pdf")
+            except Exception as e:
+                st.warning(f"PDF 미리보기 생성 실패: {e}")
+
+st.caption("※ 템플릿은 반드시 .HWPX 파일이어야 합니다. (.HWP 사용 불가)  •  '종료연도' 자리에는 '생산연도(범위)'가 채워지도록 설계되어 있습니다.")