@nhnpayco-dev/mcp-devcenter 1.0.0

package/dist/data/sitemap.json

@@ -0,0 +1,302 @@
+[
+  {
+    "text": "결제/정산 대사",
+    "href": "/guide/calculate?id=220401040",
+    "path": "/guide/calculate",
+    "id": "220401040"
+  },
+  {
+    "text": "② POS, KIOSK",
+    "href": "/guide/membership/api/pos?id=220401036",
+    "path": "/guide/membership/api/pos",
+    "id": "220401036"
+  },
+  {
+    "text": "API 연동하기",
+    "href": "/guide/membership/api/web?id=220401035",
+    "path": "/guide/membership/api/web",
+    "id": "220401035"
+  },
+  {
+    "text": "검수하기",
+    "href": "/guide/membership/check?id=220401038",
+    "path": "/guide/membership/check",
+    "id": "220401038"
+  },
+  {
+    "text": "코드 정리",
+    "href": "/guide/membership/code/start?id=220401037",
+    "path": "/guide/membership/code/start",
+    "id": "220401037"
+  },
+  {
+    "text": "소스코드 샘플",
+    "href": "/guide/membership/sample?id=220401039",
+    "path": "/guide/membership/sample",
+    "id": "220401039"
+  },
+  {
+    "text": "멤버십 클라우드",
+    "href": "/guide/membership/start?id=220401033",
+    "path": "/guide/membership/start",
+    "id": "220401033"
+  },
+  {
+    "text": "VMEM 연동하기",
+    "href": "/guide/membership/vmem/start?id=220401034",
+    "path": "/guide/membership/vmem/start",
+    "id": "220401034"
+  },
+  {
+    "text": "③ 결제 승인",
+    "href": "/guide/offline/api/approval?id=2204010244",
+    "path": "/guide/offline/api/approval",
+    "id": "2204010244"
+  },
+  {
+    "text": "④ 결제 취소",
+    "href": "/guide/offline/api/cancel?id=2204010245",
+    "path": "/guide/offline/api/cancel",
+    "id": "2204010245"
+  },
+  {
+    "text": "① API 공통 규약",
+    "href": "/guide/offline/api/common?id=2204010242",
+    "path": "/guide/offline/api/common",
+    "id": "2204010242"
+  },
+  {
+    "text": "API 연동하기",
+    "href": "/guide/offline/api/flow?id=2204010241",
+    "path": "/guide/offline/api/flow",
+    "id": "2204010241"
+  },
+  {
+    "text": "⑤ 결제 망취소",
+    "href": "/guide/offline/api/netCancel?id=2204010246",
+    "path": "/guide/offline/api/netCancel",
+    "id": "2204010246"
+  },
+  {
+    "text": "② POS 등록",
+    "href": "/guide/offline/api/pos?id=2204010243",
+    "path": "/guide/offline/api/pos",
+    "id": "2204010243"
+  },
+  {
+    "text": "검수하기",
+    "href": "/guide/offline/check?id=220401026",
+    "path": "/guide/offline/check",
+    "id": "220401026"
+  },
+  {
+    "text": "코드정리",
+    "href": "/guide/offline/code/start?id=220401025",
+    "path": "/guide/offline/code/start",
+    "id": "220401025"
+  },
+  {
+    "text": "소스코드 샘플",
+    "href": "/guide/offline/sample?id=220401027",
+    "path": "/guide/offline/sample",
+    "id": "220401027"
+  },
+  {
+    "text": "오프라인 결제",
+    "href": "/guide/offline/start?id=220401022",
+    "path": "/guide/offline/start",
+    "id": "220401022"
+  },
+  {
+    "text": "② DLL 사용하기",
+    "href": "/guide/offline/vcat/dll?id=2204010233",
+    "path": "/guide/offline/vcat/dll",
+    "id": "2204010233"
+  },
+  {
+    "text": "VCAT 연동하기",
+    "href": "/guide/offline/vcat/flow?id=2204010231",
+    "path": "/guide/offline/vcat/flow",
+    "id": "2204010231"
+  },
+  {
+    "text": "① VCAT 알아보기",
+    "href": "/guide/offline/vcat/vcat?id=2204010232",
+    "path": "/guide/offline/vcat/vcat",
+    "id": "2204010232"
+  },
+  {
+    "text": "⑤ 결제 취소/삭제",
+    "href": "/guide/online/autopay/cancel?id=220401012",
+    "path": "/guide/online/autopay/cancel",
+    "id": "220401012"
+  },
+  {
+    "text": "자동결제 연동하기",
+    "href": "/guide/online/autopay/flow?id=220401007",
+    "path": "/guide/online/autopay/flow",
+    "id": "220401007"
+  },
+  {
+    "text": "③ 결제 정보조회",
+    "href": "/guide/online/autopay/info?id=220401010",
+    "path": "/guide/online/autopay/info",
+    "id": "220401010"
+  },
+  {
+    "text": "④ 결제 승인",
+    "href": "/guide/online/autopay/payment?id=220401011",
+    "path": "/guide/online/autopay/payment",
+    "id": "220401011"
+  },
+  {
+    "text": "① 결제창 호출",
+    "href": "/guide/online/autopay/reserve?id=220401008",
+    "path": "/guide/online/autopay/reserve",
+    "id": "220401008"
+  },
+  {
+    "text": "② 결제 인증",
+    "href": "/guide/online/autopay/return?id=220401009",
+    "path": "/guide/online/autopay/return",
+    "id": "220401009"
+  },
+  {
+    "text": "검수하기",
+    "href": "/guide/online/check?id=220401020",
+    "path": "/guide/online/check",
+    "id": "220401020"
+  },
+  {
+    "text": "코드정리",
+    "href": "/guide/online/code/start?id=220401019",
+    "path": "/guide/online/code/start",
+    "id": "220401019"
+  },
+  {
+    "text": "③ 결제 승인",
+    "href": "/guide/online/easypay/approval?id=220401005",
+    "path": "/guide/online/easypay/approval",
+    "id": "220401005"
+  },
+  {
+    "text": "④ 결제 취소",
+    "href": "/guide/online/easypay/cancel?id=220401006",
+    "path": "/guide/online/easypay/cancel",
+    "id": "220401006"
+  },
+  {
+    "text": "결제 연동하기",
+    "href": "/guide/online/easypay/flow?id=220401002",
+    "path": "/guide/online/easypay/flow",
+    "id": "220401002"
+  },
+  {
+    "text": "결제 연동하기",
+    "href": "/guide/online/easypay/reserve?id=220401002",
+    "path": "/guide/online/easypay/reserve",
+    "id": "220401002"
+  },
+  {
+    "text": "① 결제창 호출",
+    "href": "/guide/online/easypay/reserve?id=220401003",
+    "path": "/guide/online/easypay/reserve",
+    "id": "220401003"
+  },
+  {
+    "text": "② 결제 인증",
+    "href": "/guide/online/easypay/return?id=220401004",
+    "path": "/guide/online/easypay/return",
+    "id": "220401004"
+  },
+  {
+    "text": "바로구매",
+    "href": "/guide/online/etc/checkout?id=220401014",
+    "path": "/guide/online/etc/checkout",
+    "id": "220401014"
+  },
+  {
+    "text": "기타결제 연동하기",
+    "href": "/guide/online/etc/nonmember?id=220401013",
+    "path": "/guide/online/etc/nonmember",
+    "id": "220401013"
+  },
+  {
+    "text": "주문서 결제",
+    "href": "/guide/online/etc/ordersheet?id=220401015",
+    "path": "/guide/online/etc/ordersheet",
+    "id": "220401015"
+  },
+  {
+    "text": "결제 상세조회",
+    "href": "/guide/online/extra/detail?id=220401017",
+    "path": "/guide/online/extra/detail",
+    "id": "220401017"
+  },
+  {
+    "text": "영수증",
+    "href": "/guide/online/extra/receipt?id=220401018",
+    "path": "/guide/online/extra/receipt",
+    "id": "220401018"
+  },
+  {
+    "text": "부가기능",
+    "href": "/guide/online/extra/start?id=220401016",
+    "path": "/guide/online/extra/start",
+    "id": "220401016"
+  },
+  {
+    "text": "소스코드 샘플",
+    "href": "/guide/online/sample?id=220401021",
+    "path": "/guide/online/sample",
+    "id": "220401021"
+  },
+  {
+    "text": "연동하기",
+    "href": "/guide/online/start?id=220401001",
+    "path": "/guide/online/start",
+    "id": "220401001"
+  },
+  {
+    "text": "검수하기",
+    "href": "/guide/order/check?id=220401031",
+    "path": "/guide/order/check",
+    "id": "220401031"
+  },
+  {
+    "text": "코드 정리",
+    "href": "/guide/order/code/start?id=220401030",
+    "path": "/guide/order/code/start",
+    "id": "220401030"
+  },
+  {
+    "text": "소스코드 샘플",
+    "href": "/guide/order/sample?id=220401032",
+    "path": "/guide/order/sample",
+    "id": "220401032"
+  },
+  {
+    "text": "오더 클라우드",
+    "href": "/guide/order/start?id=220401028",
+    "path": "/guide/order/start",
+    "id": "220401028"
+  },
+  {
+    "text": "VORDER 연동하기",
+    "href": "/guide/order/vorder/start?id=220401029",
+    "path": "/guide/order/vorder/start",
+    "id": "220401029"
+  },
+  {
+    "text": "보안사항 확인하기",
+    "href": "/guide/secure?id=220401050",
+    "path": "/guide/secure",
+    "id": "220401050"
+  },
+  {
+    "text": "USERTrust 루트 인증서 설치 가이드",
+    "href": "/guide/secure/detail?id=220401051",
+    "path": "/guide/secure/detail",
+    "id": "220401051"
+  }
+]

package/dist/data.js

@@ -0,0 +1,42 @@
+// 데이터 로더 — data/index.json, data/error-codes.json, data/guides/*.md 를 메모리에 적재.
+import { existsSync } from "node:fs";
+import { readFile, readdir } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function findDataDir() {
+    // 1) 환경변수 명시 (운영 배포 시)
+    if (process.env.PAYCO_MCP_DATA_DIR)
+        return process.env.PAYCO_MCP_DATA_DIR;
+    // 2) 패키지 내 dist/data (npm 배포본)
+    const packaged = resolve(__dirname, "data");
+    if (existsSync(packaged))
+        return packaged;
+    // 3) 모노리포 개발 모드 — mcp-server/dist/data.js 기준 ../../data
+    const dev = resolve(__dirname, "..", "..", "data");
+    return dev;
+}
+export async function loadDataStore() {
+    const dataDir = findDataDir();
+    const indexRaw = await readFile(resolve(dataDir, "index.json"), "utf8");
+    const errorRaw = await readFile(resolve(dataDir, "error-codes.json"), "utf8");
+    const apiSpecsRaw = await readFile(resolve(dataDir, "api-specs.json"), "utf8");
+    const guidesDir = resolve(dataDir, "guides");
+    const files = await readdir(guidesDir);
+    const guides = new Map();
+    for (const f of files) {
+        if (!f.endsWith(".md"))
+            continue;
+        const slug = f.replace(/\.md$/, "");
+        const text = await readFile(resolve(guidesDir, f), "utf8");
+        guides.set(slug, text);
+    }
+    return {
+        index: JSON.parse(indexRaw),
+        errorCodes: JSON.parse(errorRaw),
+        apiSpecs: JSON.parse(apiSpecsRaw),
+        guides,
+        dataDir,
+    };
+}

package/dist/excel.js

@@ -0,0 +1,320 @@
+// 검수 결과 → xlsx 변환.
+// 3 시트: 검수요약 / 항목별 상세 / 공통검수체크리스트
+// 양식 참조: data/samples/payco_nonmember_checklist.xlsx (Arial 10pt, 진남색 헤더)
+import { mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve, isAbsolute } from "node:path";
+import ExcelJS from "exceljs";
+import { CHECKLISTS, SERVICE_LABELS } from "./tools.js";
+// ── 디자인 토큰 ──────────────────────────────────────────────
+const FONT_NAME = "Arial";
+const FONT_SIZE = 10;
+const COLOR_TITLE = "FF1F3864"; // 진남색 - 시트 제목
+const COLOR_SUBTITLE = "FF595959"; // 회색 - 서브타이틀
+const COLOR_HEADER_BG = "FF1F3864";
+const COLOR_HEADER_TEXT = "FFFFFFFF";
+const COLOR_PASS_TEXT = "FF006100";
+const COLOR_PASS_BG = "FFC6EFCE";
+const COLOR_FAIL_TEXT = "FF9C0006";
+const COLOR_FAIL_BG = "FFFFC7CE";
+const COLOR_NEUTRAL = "FF7F7F7F"; // 회색 (스킵/수동)
+const SPEC_KIND_LABEL = {
+    missing_required: "API 명세 - 필수 누락",
+    unknown_param: "API 명세 - 알 수 없는 파라미터",
+    type_mismatch: "API 명세 - 타입 불일치",
+};
+const STATUS_LABEL = {
+    pass: "✓ 통과",
+    fail: "✗ 실패",
+    skip: "⊘ 스킵",
+    manual: "⬜ 수동확인",
+};
+// ── 경로/파일명 ──────────────────────────────────────────────
+export function defaultOutputPath() {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
+        `-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return join(homedir(), "Downloads", `payco-validation-${stamp}.xlsx`);
+}
+async function ensureOutputPath(userPath) {
+    let p = userPath?.trim() || defaultOutputPath();
+    if (!isAbsolute(p))
+        p = resolve(p);
+    if (!p.toLowerCase().endsWith(".xlsx"))
+        p = `${p}.xlsx`;
+    await mkdir(dirname(p), { recursive: true });
+    return p;
+}
+// ── 공통 헬퍼 ────────────────────────────────────────────────
+function fillSolid(argb) {
+    return { type: "pattern", pattern: "solid", fgColor: { argb } };
+}
+/** 제목 행: 시트 상단 큰 글자 (Row 1, C1 한 셀, 나머지는 비움) */
+function addTitleRow(ws, text, colCount) {
+    const row = ws.addRow([text]);
+    // 첫 셀만 스타일 적용, 나머지 빈 셀에는 적용하지 않음
+    const cell = row.getCell(1);
+    cell.font = { name: FONT_NAME, size: 14, bold: true, color: { argb: COLOR_TITLE } };
+    cell.alignment = { vertical: "middle" };
+    // 시각적으로 합쳐서 보이게: 1~colCount 머지
+    ws.mergeCells(row.number, 1, row.number, colCount);
+    row.height = 24;
+}
+/** 서브타이틀 행: 검수일/대상 등 보조 정보 (Row 2) */
+function addSubtitleRow(ws, text, colCount) {
+    const row = ws.addRow([text]);
+    const cell = row.getCell(1);
+    cell.font = { name: FONT_NAME, size: 9, color: { argb: COLOR_SUBTITLE } };
+    cell.alignment = { vertical: "middle" };
+    ws.mergeCells(row.number, 1, row.number, colCount);
+    row.height = 16;
+}
+/** 빈 행 추가 (구분용) */
+function addSpacerRow(ws) {
+    ws.addRow([]);
+}
+/** 테이블 헤더 행: 진남색 배경 + 흰글자, 실제 컬럼 범위(1..colCount)에만 적용 */
+function addHeaderRow(ws, headers) {
+    const row = ws.addRow(headers);
+    for (let i = 1; i <= headers.length; i++) {
+        const cell = row.getCell(i);
+        cell.font = {
+            name: FONT_NAME, size: FONT_SIZE, bold: true,
+            color: { argb: COLOR_HEADER_TEXT },
+        };
+        cell.fill = fillSolid(COLOR_HEADER_BG);
+        cell.alignment = { vertical: "middle", horizontal: "center", wrapText: true };
+    }
+    row.height = 26;
+    return row;
+}
+/** 데이터 셀 기본 스타일 (size 10, Arial, top/wrap) */
+function styleDataCell(cell, opts = {}) {
+    const existing = (cell.font ?? {});
+    cell.font = { ...existing, name: FONT_NAME, size: FONT_SIZE };
+    cell.alignment = {
+        vertical: opts.center ? "middle" : "top",
+        horizontal: opts.center ? "center" : "left",
+        wrapText: true,
+    };
+}
+/** 검수결과 셀에 PASS/FAIL/SKIP/MANUAL 별 색상 적용 */
+function paintResultCell(cell, status) {
+    cell.alignment = { vertical: "middle", horizontal: "center", wrapText: true };
+    if (status === "pass" || status === "summary-pass") {
+        cell.font = { name: FONT_NAME, size: FONT_SIZE, bold: true, color: { argb: COLOR_PASS_TEXT } };
+        cell.fill = fillSolid(COLOR_PASS_BG);
+    }
+    else if (status === "fail" || status === "summary-fail") {
+        cell.font = { name: FONT_NAME, size: FONT_SIZE, bold: true, color: { argb: COLOR_FAIL_TEXT } };
+        cell.fill = fillSolid(COLOR_FAIL_BG);
+    }
+    else {
+        // skip / manual
+        cell.font = { name: FONT_NAME, size: FONT_SIZE, color: { argb: COLOR_NEUTRAL } };
+    }
+}
+function formatStamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+// ── Sheet 1: 검수요약 ────────────────────────────────────────
+function buildSummarySheet(wb, records) {
+    const ws = wb.addWorksheet("검수요약");
+    const widths = [5, 24, 24, 28, 36, 16, 60];
+    ws.columns = widths.map((w) => ({ width: w }));
+    const COLS = 7;
+    addTitleRow(ws, "PAYCO 검수 결과 요약", COLS);
+    addSubtitleRow(ws, `검수일: ${formatStamp()}  |  검수 건수: ${records.length}건`, COLS);
+    addSpacerRow(ws);
+    addHeaderRow(ws, [
+        "No", "가맹점주문번호", "예약주문번호", "API", "Endpoint", "검수결과", "조치 필요 사항",
+    ]);
+    // 헤더 행 번호를 frozen 기준점으로 사용
+    const headerRowNum = ws.rowCount;
+    ws.views = [{ state: "frozen", ySplit: headerRowNum }];
+    records.forEach((rec, i) => {
+        const fails = rec.specIssues.length + rec.checklistRuns.filter((c) => c.status === "fail").length;
+        const resultText = rec.pass ? "✓ PASS" : `✗ FAIL (${fails})`;
+        const actionLines = [];
+        for (const s of rec.specIssues) {
+            actionLines.push(`[${SPEC_KIND_LABEL[s.kind] ?? s.kind}] ${s.message}`);
+        }
+        for (const c of rec.checklistRuns) {
+            if (c.status === "fail") {
+                actionLines.push(`[체크리스트-${c.category}] ${c.title}${c.message ? ` — ${c.message}` : ""}`);
+            }
+        }
+        const row = ws.addRow([
+            i + 1,
+            rec.sellerOrderRefKey ?? "",
+            rec.reserveOrderNo ?? "",
+            rec.api,
+            rec.endpoint,
+            resultText,
+            actionLines.join("\n"),
+        ]);
+        // 모든 셀 기본 스타일
+        for (let c = 1; c <= COLS; c++)
+            styleDataCell(row.getCell(c));
+        // No 컬럼 가운데 정렬
+        row.getCell(1).alignment = { vertical: "middle", horizontal: "center", wrapText: true };
+        // 검수결과 컬럼 색 처리
+        paintResultCell(row.getCell(6), rec.pass ? "summary-pass" : "summary-fail");
+        row.height = Math.min(96, Math.max(22, actionLines.length * 14 + 8));
+    });
+}
+// ── Sheet 2: 항목별 상세 ─────────────────────────────────────
+function buildDetailSheet(wb, records) {
+    const ws = wb.addWorksheet("항목별 상세");
+    const widths = [5, 22, 22, 24, 30, 36, 16, 50];
+    ws.columns = widths.map((w) => ({ width: w }));
+    const COLS = 8;
+    addTitleRow(ws, "API별 검증 항목 상세", COLS);
+    addSubtitleRow(ws, `검수일: ${formatStamp()}  |  검수 건수: ${records.length}건`, COLS);
+    addSpacerRow(ws);
+    addHeaderRow(ws, [
+        "No", "가맹점주문번호", "예약주문번호", "API", "Endpoint", "검증항목", "검수결과", "조치 필요 사항",
+    ]);
+    const headerRowNum = ws.rowCount;
+    ws.views = [{ state: "frozen", ySplit: headerRowNum }];
+    let rowNo = 0;
+    records.forEach((rec, recIdx) => {
+        // API 명세 이슈만 표시 (체크리스트는 공통검수체크리스트 시트에서 다룸)
+        for (const s of rec.specIssues) {
+            rowNo++;
+            const row = ws.addRow([
+                rowNo,
+                rec.sellerOrderRefKey ?? "",
+                rec.reserveOrderNo ?? "",
+                rec.api,
+                rec.endpoint,
+                SPEC_KIND_LABEL[s.kind] ?? s.kind,
+                "✗ 실패",
+                s.message,
+            ]);
+            for (let c = 1; c <= COLS; c++)
+                styleDataCell(row.getCell(c));
+            row.getCell(1).alignment = { vertical: "middle", horizontal: "center", wrapText: true };
+            paintResultCell(row.getCell(7), "fail");
+            row.height = 24;
+        }
+        if (recIdx < records.length - 1)
+            ws.addRow([]);
+    });
+}
+// ── Sheet 3: 공통검수체크리스트 ──────────────────────────────
+// 서비스 단위 체크리스트.
+// - 자동 항목: 해당 서비스의 모든 record 를 집계해 결과 표시 (하나라도 fail 이면 ✗)
+// - 수동 항목: 자동 검증 불가 → 결과 빈값
+// - 조치 필요 사항: 서비스 그룹의 첫 행에만 endpoint(record) 단위로 정리해서 표시
+function buildChecklistSheet(wb, records) {
+    const ws = wb.addWorksheet("공통검수체크리스트");
+    const widths = [14, 18, 50, 50, 16, 60];
+    ws.columns = widths.map((w) => ({ width: w }));
+    const COLS = 6;
+    const presentServices = Array.from(new Set(records.map((r) => r.service)))
+        .filter((s) => s in SERVICE_LABELS);
+    const presentServiceLabels = presentServices.map((s) => SERVICE_LABELS[s]);
+    addTitleRow(ws, "공통 검수 체크리스트", COLS);
+    addSubtitleRow(ws, `검수일: ${formatStamp()}  |  대상 서비스: ${presentServiceLabels.join(", ") || "(없음)"}  |  검수 건수: ${records.length}건`, COLS);
+    addSpacerRow(ws);
+    addHeaderRow(ws, ["서비스", "카테고리", "검수 항목", "비고/설명", "검수결과", "조치 필요 사항"]);
+    const headerRowNum = ws.rowCount;
+    ws.views = [{ state: "frozen", ySplit: headerRowNum }];
+    const itemStatusByService = {};
+    for (const rec of records) {
+        const svcMap = itemStatusByService[rec.service] ??= {};
+        for (const c of rec.checklistRuns) {
+            if (c.status === "manual")
+                continue;
+            const cur = svcMap[c.title];
+            if (c.status === "fail")
+                svcMap[c.title] = "fail";
+            else if (c.status === "pass" && cur !== "fail")
+                svcMap[c.title] = "pass";
+            else if (c.status === "skip" && !cur)
+                svcMap[c.title] = "skip";
+        }
+    }
+    for (const svc of presentServices) {
+        const label = SERVICE_LABELS[svc];
+        const list = CHECKLISTS[svc] ?? [];
+        // 이 서비스의 모든 record 의 조치사항 통합 (endpoint 단위로 헤더 + 줄로 정리)
+        const svcRecords = records.filter((r) => r.service === svc);
+        const actionLines = [];
+        for (const rec of svcRecords) {
+            const lines = [];
+            for (const s of rec.specIssues) {
+                lines.push(`  · [${SPEC_KIND_LABEL[s.kind] ?? s.kind}] ${s.message}`);
+            }
+            for (const c of rec.checklistRuns) {
+                if (c.status === "fail") {
+                    lines.push(`  · [체크리스트-${c.category}] ${c.title}${c.message ? ` — ${c.message}` : ""}`);
+                }
+            }
+            if (lines.length > 0) {
+                const orderKey = rec.sellerOrderRefKey ? ` / ${rec.sellerOrderRefKey}` : "";
+                actionLines.push(`■ ${rec.api}${orderKey}`);
+                actionLines.push(...lines);
+            }
+        }
+        const actionText = actionLines.length > 0
+            ? actionLines.join("\n")
+            : "(이 서비스 검수에서 자동 검증 실패·명세 위반 없음)";
+        list.forEach((item, idx) => {
+            const isFirst = idx === 0;
+            const isAuto = !!item.autoCheck;
+            let resultText = "";
+            let resultStyle = null;
+            if (isAuto) {
+                const status = itemStatusByService[svc]?.[item.title];
+                if (status === "pass") {
+                    resultText = "✓ 통과";
+                    resultStyle = "pass";
+                }
+                else if (status === "fail") {
+                    resultText = "✗ 실패";
+                    resultStyle = "fail";
+                }
+                else if (status === "skip") {
+                    resultText = "⊘ 스킵";
+                    resultStyle = "skip";
+                }
+            }
+            const row = ws.addRow([
+                label,
+                item.category,
+                item.title,
+                item.detail ?? "",
+                resultText,
+                isFirst ? actionText : "",
+            ]);
+            for (let c = 1; c <= COLS; c++)
+                styleDataCell(row.getCell(c));
+            if (resultStyle)
+                paintResultCell(row.getCell(5), resultStyle);
+            else
+                row.getCell(5).alignment = { vertical: "middle", horizontal: "center", wrapText: true };
+            row.height = 22;
+        });
+        // 서비스 사이 빈 행
+        if (svc !== presentServices[presentServices.length - 1])
+            ws.addRow([]);
+    }
+}
+// ── 메인 export 함수 ─────────────────────────────────────────
+export async function exportValidationToExcel(records, userPath) {
+    const wb = new ExcelJS.Workbook();
+    wb.creator = "payco-mcp-devcenter";
+    wb.created = new Date();
+    buildSummarySheet(wb, records);
+    buildDetailSheet(wb, records);
+    buildChecklistSheet(wb, records);
+    const outPath = await ensureOutputPath(userPath);
+    await wb.xlsx.writeFile(outPath);
+    const detailRows = records.reduce((sum, r) => sum + r.specIssues.length + r.checklistRuns.length, 0);
+    return { path: outPath, recordCount: records.length, rowCount: detailRows };
+}