refactor(M02): 자재 조합 표를 마스터 템플릿으로 옮김 · M02 좌측 「자재 조합」 컨테이너

- 표 resources/master_data/자재조합.json → resources/master_template/자재조합.json(git mv) · 키 UM 은 표 안 「다음」 번호 · _키대장 · master_keys 의 UM 뺌 · check_master 틀이 새 자리를 같이 봄
- 서버: M01 /api/m01/matset* 뺌 · M02 저장소 M02_MasterTemplete_Matset.py(목록 · 새로 · 고치기 · 지우기 · 쓰는 열 검사) · 길 GET/POST /api/m02/material-combos · PUT/DELETE /api/m02/material-combos/{키} · 갈라 내기(branchMaterialCombo)도 이 저장소로
- 화면: M01 좌측 「자재 조합」 컨테이너 뺌 · M02 좌측 「자재 조합」 컨테이너(찾기 · 키 맨 앞 목록 · 새로 · 본떠 만들기 · 지우기) · 메인 칸 상세(이름 · 비고 · 본뜬키 · 담은 자재 표 · 자재 더하기 · 빼기 · 저장) · 쓰는 열이 있으면 지우기는 확인 창 없이 알림
- 시험: test_m01_matset → test_m02_matset · test_m02_combo_branch 사본 자리 · 실제 자재 코드

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VwJQ5eRrCKf3nH9EFeKvJz

M01_MasterData/M01_MasterData_Router.py

@@ -15,7 +15,6 @@ from pydantic import BaseModel
 from M01_MasterData import M01_MasterData_Store as store
 from M01_MasterData import M01_MasterData_Store_Combo as combo_store
 from M01_MasterData import M01_MasterData_Store_Make as make
-from M01_MasterData import M01_MasterData_Store_Matset as matset_store
 
 router = APIRouter(prefix="/api/m01", tags=["M01 MasterData"])
 
@@ -115,20 +114,6 @@ class PreviewCombo(BaseModel):
     inputs: dict[str, dict[str, Any]] = {}
 
 
-class NewMatset(BaseModel):
-    """자재 조합 — 담은 자재 목록만(코드 · 이름 · 규격 · 단위 · 수량 · 단가는 안 둠)."""
-
-    matset: dict[str, Any]
-    owner: str = matset_store.OWNERS[0]
-
-
-class EditMatset(BaseModel):
-    key: str
-    version: str
-    matset: dict[str, Any]
-    owner: str = ""
-
-
 class DraftLogic(BaseModel):
     text: str  # 줄로 적은 식 — 줄마다 「이름 = 식」
     decided: dict[str, Any] = {}  # 변수마다 정한 것 {이름: {무엇, 단위, 비목, 요소·찾기·값}}
@@ -364,29 +349,3 @@ def post_combo_delete(body: DeleteCombo) -> dict:
 def post_combo_preview(body: PreviewCombo) -> dict:
     """담은 로직마다 값을 뽑아 비목별로 갈라 합계 — 저장하지 않음."""
     return _call(combo_store.combo_preview, body.combo, body.inputs)
-
-
-# ── 자재 조합(계약 9장 끝) ─────────────────────────────────────────────
-@router.get("/matsets")
-def get_matsets(q: str = "", owner: str = "") -> dict:
-    return {"matsets": _call(matset_store.matsets, q, owner)}
-
-
-@router.get("/matset")
-def get_matset(key: str) -> dict:
-    return _call(matset_store.matset, key)
-
-
-@router.post("/matset/new")
-def post_matset_new(body: NewMatset) -> dict:
-    return _call(matset_store.matset_new, body.matset, body.owner)
-
-
-@router.post("/matset/edit")
-def post_matset_edit(body: EditMatset) -> dict:
-    return _call(matset_store.matset_edit, body.key, body.version, body.matset, body.owner)
-
-
-@router.post("/matset/delete")
-def post_matset_delete(body: DeleteCombo) -> dict:
-    return _call(matset_store.matset_delete, body.key, body.version)

M01_MasterData/M01_MasterData_Store_Matset.py

@@ -1,136 +0,0 @@
-"""M01 자재 조합 저장소 — 목록 · 하나 읽기 · 만들기 · 고치기 · 지우기.
-
-계약: `_화면_계약.md` 9장 끝 · 파일 모양: `_틀.md` 11장 · 엔진: `scripts/master_matset.py`.
-조합은 담은 자재 목록(코드 · 이름 · 규격 · 단위)만 지님 — 수량 · 단가는 두지 않음(재료산출 몫).
-자리는 `자재조합.json` 한 파일 · 키는 `_키대장.json` 의 `UM` 다음 번호(서버가 줌).
-"""
-
-from __future__ import annotations
-
-from datetime import date
-from pathlib import Path
-
-from M01_MasterData import M01_MasterData_Store as store
-from M01_MasterData import M01_MasterData_Store_Combo as combos
-
-cm = store.cm
-msk = cm.mmc  # sub4 가 세운 자재 조합 엔진(`scripts/master_material_combo.py`)
-
-FILE = msk.FILE
-OWNERS = msk.OWNERS
-
-
-def _path() -> Path:
-    return store.FOLDER / FILE
-
-
-def _make_file() -> None:
-    """파일이 없으면 머리만 두고 만듦."""
-    if not _path().is_file():
-        head = {"그룹": msk.GROUP, "판": str(date.today().year), "줄": []}
-        _path().write_text(store.dump(head), encoding="utf-8", newline="\n")
-
-
-def _read() -> tuple[dict, str]:
-    _make_file()
-    return store.read(FILE)
-
-
-def _keys() -> list[str]:
-    return [str(r.get("키")) for r in _read()[0].get("줄") or []]
-
-
-def _find(data: dict, key: str) -> dict:
-    for row in data.get("줄") or []:
-        if str(row.get("키")) == key:
-            return row
-    raise store.StoreError(404, f"없는 자재 조합 「{key}」")
-
-
-def _clean(one: dict, owner: str, key: str | None = None) -> dict:
-    """서버가 잡는 칸 — 키 · 소유 · 열 한 벌(안 준 칸은 null · 자재 줄은 네 칸만)."""
-    if not isinstance(one, dict):
-        raise store.StoreError(400, "자재 조합 줄이 묶음 아님")
-    name = one.get("이름")
-    if not isinstance(name, str) or not name.strip():
-        raise store.StoreError(400, "자재 조합 줄에 「이름」 이 없거나 글자 아님")
-    if owner not in OWNERS:
-        raise store.StoreError(400, f"모르는 소유 「{owner}」 — {' · '.join(OWNERS)}")
-    origin = one.get("본뜬키")
-    if origin is not None and (origin == key or origin not in _keys()):
-        raise store.StoreError(400, f"본뜬키 「{origin}」 — 비었거나 있는 다른 자재 조합 키여야 함")
-    got = one.get("담은자재")
-    if isinstance(got, list):  # 화면이 덤을 실어도 자재 줄은 네 칸만 · 안 준 칸은 빈 글
-        got = [{c: m.get(c, "") for c in msk.ITEM_COLS} if isinstance(m, dict) else m for m in got]
-    rest = {k: v for k, v in one.items() if k not in ("키", "원문번호", "소유")}
-    _check_codes(got)
-    row = {**({"키": key} if key else {}), "소유": owner, **rest, "담은자재": got or []}
-    for col in msk.COLS:
-        row.setdefault(col, None)
-    return {k: row[k] for k in msk.COLS if k in row}
-
-
-def _check_codes(got) -> None:
-    """담은 자재 코드가 마스터 어느 줄에도 없으면 422 — 틀 검사는 저장 길(`store.save`)이 함."""
-    if not isinstance(got, list) or not got:
-        return
-    known = {str(r.get("키")) for d in store.loaded()[0].values() for r in d.get("줄") or []}
-    lost = [str(m.get("코드")) for m in got if isinstance(m, dict) and m.get("코드") not in known]
-    if lost:
-        raise store.StoreError(422, {"errors": [f"마스터에 없는 자재 {' · '.join(lost)}"]})
-
-
-def _write(changes: list[dict], version: str | None = None) -> dict:
-    _make_file()
-    return store.save(
-        [{"file": FILE, "version": version or store.read(FILE)[1], "changes": changes}]
-    )[0]
-
-
-def matsets(q: str = "", owner: str = "") -> list[dict]:
-    """목록 — 찾기(이름 · 키)와 소유로 거름 · 줄마다 자재 수."""
-    out = []
-    for row in store.loaded()[0].get(FILE, {}).get("줄") or []:
-        if owner and row.get("소유") != owner:
-            continue
-        if not store._hit(row, q):
-            continue
-        out.append(
-            {k: row.get(k) for k in msk.COLS if k != "담은자재"}
-            | {"file": FILE, "count": len(msk.items(row))}
-        )
-    return out
-
-
-def matset(key: str) -> dict:
-    data, version = _read()
-    return {"file": FILE, "version": version, "matset": _find(data, key)}
-
-
-def matset_new(one: dict, owner: str = OWNERS[0]) -> dict:
-    """새 자재 조합 — 키는 서버가 `UM` 다음 번호로 줌."""
-    before = set(_keys())
-    done = _write([{"op": "add", "row": _clean(one, owner)}])
-    key = next((k for k in reversed(_keys()) if k not in before), "")
-    return {**done, "key": key, "matset": _find(_read()[0], key) if key else {}}
-
-
-def matset_edit(key: str, version: str, one: dict, owner: str = "") -> dict:
-    data, _ = _read()
-    was = _find(data, key)
-    if store.read(FILE)[1] != version:
-        raise store.StoreError(409, {"stale": [FILE]})
-    fixed = _clean(one, owner or str(was.get("소유") or OWNERS[0]), key)
-    done = _write([{"op": "edit", "key": key, "row": fixed}], version)
-    return {**done, "matset": _find(_read()[0], key)}
-
-
-def matset_delete(key: str, version: str) -> dict:
-    """지우기 — 구조물 열이 「자재조합」 칸으로 쓰면 409 + 구조물 이름들(지우지 않음)."""
-    _find(_read()[0], key)
-    if users := combos.users_of("자재조합", key):
-        msg = f"구조물 {len(users)} 곳이 쓰는 자재 조합이라 못 지움 — {' · '.join(users)}"
-        raise store.StoreError(409, {"errors": [msg], "users": users})
-    if store.read(FILE)[1] != version:
-        raise store.StoreError(409, {"stale": [FILE]})
-    return _write([{"op": "delete", "key": key}], version)

M01_MasterData/M01_MasterData_UI_Matset.ts

@@ -1,367 +0,0 @@
-/* =============================================================================
- * M01_MasterData_UI_Matset.ts
- * 자재 조합 화면 — 왼쪽 컨테이너(찾기) / 오른쪽 목록 · 상세 (일위대가 조합 화면과 같은 틀)
- * 상세 = 이름 · 비고 + 본뜬키 줄 + 담은 자재 표(코드 · 이름 · 규격 · 단위 · 빼기) + [자재 더하기]
- * 저장 · 지우기는 서버 자재 조합 마스터(`자재조합.json` · 키 UM) — 길은 `Matset_Api` 한 곳
- * ========================================================================== */
-
-import {
-  createButton,
-  createInputField,
-  el,
-  showConfirmDialog,
-  showToast,
-} from "@ui/ui_template_elements";
-import { searchMaterials } from "./M01_MasterData_Api_Fetch";
-import { ApiError } from "./M01_MasterData_UI_Logic_Api";
-import {
-  deleteMatset,
-  editMatset,
-  fetchMatset,
-  fetchMatsets,
-  newMatset,
-  type MatItem,
-  type Matset,
-  type MatsetSummary,
-} from "./M01_MasterData_UI_Matset_Api";
-import { tm } from "./M01_MasterData_UI_Matset_Text";
-import type { SideHandle } from "./M01_MasterData_UI_Side";
-import "./M01_MasterData_UI_Logic_Style.css";
-import "./M01_MasterData_UI_LogicLab_Style.css";
-
-const blank = (): Matset => ({
-  키: "",
-  이름: "",
-  담은자재: [],
-  본뜬키: null,
-  소유: "현장",
-  비고: null,
-});
-
-/** 서버가 준 까닭 — 422 · 409(지우기 막음) 는 글 목록 · 409 낡은 판본은 stale */
-function reason(error: unknown): string {
-  if (error instanceof ApiError && typeof error.detail === "object" && error.detail) {
-    const d = error.detail as { errors?: string[]; stale?: string[] };
-    if (d.errors) return d.errors.join(" / ");
-    if (d.stale) return tm("Stale");
-  }
-  return error instanceof Error ? error.message : tm("Load_Failed");
-}
-
-const fail = (error: unknown): void =>
-  showToast(error instanceof Error ? error.message : tm("Load_Failed"), "error");
-
-/** [자재 더하기] 창 — 낱말로 자재DB 를 찾아 하나씩 고름 */
-function openMaterialPicker(have: Set<string>, done: (item: MatItem) => void): void {
-  const search = createInputField({ type: "search", placeholder: tm("Pick_Search") });
-  const list = el("div", { className: "m01-logic__pick-list" });
-  const hint = el("p", { className: "m01-logic__muted", text: tm("Pick_Hint") });
-  const close = (): void => backdrop.remove();
-  const find = async (): Promise<void> => {
-    try {
-      const found = await searchMaterials(search.input.value.trim());
-      hint.textContent = found.length ? String(found.length) : tm("Pick_None");
-      list.replaceChildren(
-        ...found.map((x) => {
-          const taken = have.has(x.코드);
-          const row = el("button", {
-            className: "m01-logic__pick-row m01-logic__pick-row--button",
-            attrs: { type: "button", "data-pick": x.코드, ...(taken ? { disabled: "" } : {}) },
-            children: [
-              el("div", {
-                className: "m01-logic__stack",
-                children: [
-                  el("strong", { text: x.이름 }),
-                  el("span", { className: "m01-logic__muted", text: `${x.코드} · ${x.규격}` }),
-                ],
-              }),
-              el("span", { text: taken ? tm("Pick_Have") : x.단위 }),
-            ],
-          });
-          row.addEventListener("click", () => {
-            close();
-            done(x);
-          });
-          return row;
-        }),
-      );
-    } catch (error) {
-      fail(error);
-    }
-  };
-  search.input.addEventListener("keydown", (ev) => ev.key === "Enter" && void find());
-  const dialog = el("div", {
-    className: "m01-logic__pick",
-    attrs: { role: "dialog", "aria-label": tm("Pick_Title") },
-    children: [
-      el("div", {
-        className: "m01-logic__section-head",
-        children: [
-          el("h3", { text: tm("Pick_Title") }),
-          createButton({ label: tm("Pick_Close"), variant: "ghost", onClick: close }),
-        ],
-      }),
-      el("div", {
-        className: "m01-logic__filters",
-        children: [
-          search.root,
-          createButton({ label: tm("Pick_Find"), variant: "filled", onClick: () => void find() }),
-        ],
-      }),
-      hint,
-      list,
-    ],
-  });
-  const backdrop = el("div", { className: "m01-logic__backdrop", children: [dialog] });
-  backdrop.addEventListener("click", (ev) => ev.target === backdrop && close());
-  backdrop.addEventListener("keydown", (ev) => ev.key === "Escape" && close());
-  document.body.append(backdrop);
-  search.input.focus();
-}
-
-export interface MatsetHandle {
-  /** 컨테이너를 펼칠 때 — 목록을 새로 받아 그림 */
-  show: () => Promise<void>;
-}
-
-export function mountM01Matset(host: HTMLElement, side: SideHandle): MatsetHandle {
-  let items: MatsetSummary[] = [];
-  let q = "";
-  /** 화면을 바꾼 횟수 — 늦게 온 답은 이 값이 달라졌으면 버림 */
-  let nav = 0;
-  /** 열어 둔 상세 — 다른 화면에 갔다 와도 그대로 돌아오게 기억 */
-  let current: { matset: Matset; version: string } | null = null;
-  const view = el("div", { className: "m01-logic__editor" });
-  host.replaceChildren(view);
-
-  const find = createInputField({ type: "search", placeholder: tm("Search") });
-  find.input.addEventListener("input", () => {
-    q = find.input.value.trim().toLowerCase();
-    if (!current) drawList();
-  });
-  side.matsetHost.replaceChildren(find.root);
-
-  const load = async (redraw = true): Promise<void> => {
-    const my = nav;
-    try {
-      items = await fetchMatsets();
-    } catch (error) {
-      fail(error);
-    }
-    if (redraw && my === nav) drawList();
-  };
-
-  const show = async (): Promise<void> => {
-    if (!items.length && !current) {
-      view.replaceChildren(el("p", { className: "m01-logic__muted", text: tm("Loading") }));
-    }
-    await load(false);
-    if (current) draw(current.matset, current.version);
-    else drawList();
-  };
-
-  /* --- 목록 --- */
-  const drawList = (): void => {
-    nav++;
-    current = null;
-    const shown = items.filter((x) => !q || `${x.키} ${x.이름}`.toLowerCase().includes(q));
-    const heads = [
-      tm("Head_Key"),
-      tm("Head_Name"),
-      tm("Head_Count"),
-      tm("Head_Origin"),
-      tm("Head_Owner"),
-    ];
-    const rows = shown.map((x) => {
-      const tr = el("tr", {
-        className: "m01-master__table-row",
-        attrs: { "data-matset-key": x.키 },
-        children: [x.키, x.이름, String(x.count), x.본뜬키 ?? tm("Origin_Self"), x.소유 ?? ""].map(
-          (v) => el("td", { text: v }),
-        ),
-      });
-      tr.addEventListener("click", () => void open(x.키));
-      return tr;
-    });
-    view.replaceChildren(
-      el("div", {
-        className: "m01-logic__section-head",
-        children: [
-          createButton({ label: tm("New"), variant: "filled", onClick: () => draw(blank(), "") }),
-        ],
-      }),
-      shown.length
-        ? el("div", {
-            className: "m01-master__grid-wrap",
-            children: [
-              el("table", {
-                className: "m01-master__grid",
-                children: [
-                  el("thead", {
-                    children: [el("tr", { children: heads.map((t) => el("th", { text: t })) })],
-                  }),
-                  el("tbody", { children: rows }),
-                ],
-              }),
-            ],
-          })
-        : el("p", { className: "m01-logic__muted", text: tm("Empty") }),
-    );
-  };
-
-  const open = async (key: string): Promise<void> => {
-    try {
-      const my = ++nav;
-      const one = await fetchMatset(key);
-      if (my !== nav) return;
-      draw(one.matset, one.version);
-    } catch (error) {
-      fail(error);
-    }
-  };
-
-  /* --- 상세 --- */
-  const draw = (matset: Matset, version: string): void => {
-    nav++;
-    current = { matset, version };
-    const field = (label: string, name: "이름" | "비고") => {
-      const f = createInputField({ type: "text", label });
-      f.input.value = matset[name] ?? "";
-      f.input.setAttribute("data-matset-field", name);
-      f.input.addEventListener("input", () => {
-        if (name === "이름") matset.이름 = f.input.value;
-        else matset.비고 = f.input.value || null;
-      });
-      return f.root;
-    };
-    const table = el("div", { className: "m01-master__grid-wrap" });
-    const drawTable = (): void => {
-      const trs = matset.담은자재.map((m, i) =>
-        el("tr", {
-          attrs: { "data-matset-item": m.코드 },
-          children: [
-            el("td", { text: m.코드 }),
-            el("td", { text: m.이름 }),
-            el("td", { text: m.규격 }),
-            el("td", { text: m.단위 }),
-            el("td", {
-              children: [
-                createButton({
-                  label: tm("Remove"),
-                  variant: "ghost",
-                  size: "sm",
-                  onClick: () => {
-                    matset.담은자재.splice(i, 1);
-                    drawTable();
-                  },
-                }),
-              ],
-            }),
-          ],
-        }),
-      );
-      const heads = [
-        tm("Col_Code"),
-        tm("Col_Name"),
-        tm("Col_Spec"),
-        tm("Col_Unit"),
-        tm("Col_Move"),
-      ];
-      table.replaceChildren(
-        el("table", {
-          className: "m01-master__grid",
-          children: [
-            el("thead", {
-              children: [el("tr", { children: heads.map((t) => el("th", { text: t })) })],
-            }),
-            el("tbody", { children: trs }),
-          ],
-        }),
-        ...(trs.length ? [] : [el("p", { className: "m01-logic__muted", text: tm("NoItem") })]),
-      );
-    };
-    drawTable();
-
-    const add = createButton({
-      label: tm("AddItem"),
-      variant: "filled",
-      onClick: () =>
-        openMaterialPicker(new Set(matset.담은자재.map((m) => m.코드)), (x) => {
-          matset.담은자재.push({ 코드: x.코드, 이름: x.이름, 규격: x.규격, 단위: x.단위 });
-          drawTable();
-        }),
-    });
-    const save = createButton({
-      label: tm("Save"),
-      variant: "filled",
-      onClick: async () => {
-        if (!matset.이름.trim()) return showToast(tm("NeedName"), "error");
-        if (!matset.담은자재.length) return showToast(tm("NeedItem"), "error");
-        const my = nav;
-        try {
-          const key = matset.키 ? matset.키 : (await newMatset(matset)).key;
-          if (matset.키) await editMatset(matset.키, version, matset);
-          showToast(tm("Saved"), "success");
-          await load(false);
-          if (my !== nav) {
-            if (current?.matset === matset) current = null; // 저장 사이에 나감 — 옛 판본을 붙들지 않음
-            return;
-          }
-          await open(key);
-        } catch (error) {
-          showToast(reason(error), "error");
-        }
-      },
-    });
-    const remove = createButton({
-      label: tm("Delete"),
-      variant: "ghost",
-      onClick: async () => {
-        if (!matset.키 || !(await showConfirmDialog(tm("DeleteAsk")))) return;
-        try {
-          await deleteMatset(matset.키, version);
-          showToast(tm("Deleted"), "success");
-          await load();
-        } catch (error) {
-          showToast(reason(error), "error");
-        }
-      },
-    });
-    const back = createButton({ label: "←", variant: "ghost", onClick: () => drawList() });
-    view.replaceChildren(
-      el("div", {
-        className: "m01-logic__section-head",
-        children: [back, el("h3", { text: matset.키 || tm("New") }), remove, save],
-      }),
-      el("section", {
-        className: "m01lab__box m01-logic__section",
-        children: [
-          el("div", {
-            className: "m01lab__info",
-            children: [
-              field(tm("Head_Name"), "이름"),
-              field(tm("Head_Note"), "비고"),
-              el("p", {
-                className: "m01-logic__muted",
-                text: `${tm("Head_Origin")}: ${matset.본뜬키 ?? tm("Origin_Self")}`,
-                attrs: { "data-matset-origin": matset.본뜬키 ?? "" },
-              }),
-            ],
-          }),
-        ],
-      }),
-      el("section", {
-        className: "m01lab__box m01-logic__section",
-        children: [
-          el("div", {
-            className: "m01-logic__section-head",
-            children: [el("h3", { text: tm("Items_Title") }), add],
-          }),
-          table,
-        ],
-      }),
-    );
-  };
-
-  return { show };
-}

M01_MasterData/M01_MasterData_UI_Matset_Api.ts

@@ -1,60 +0,0 @@
-/* =============================================================================
- * M01_MasterData_UI_Matset_Api.ts
- * 자재 조합(`자재조합.json` · 키 UM) 서버 길 — 목록 · 하나 · 새로 · 고치기 · 지우기
- * 계약: `resources/master_data/_화면_계약.md` 9장 「자재 조합」
- * ========================================================================== */
-
-import { API_BASE_URL } from "@config/config_frontend";
-import { ApiError } from "./M01_MasterData_UI_Logic_Api";
-
-/** 담은 자재 한 줄 — 고를 때의 사본(수량 · 단가는 안 둠) */
-export interface MatItem {
-  코드: string;
-  이름: string;
-  규격: string;
-  단위: string;
-}
-export interface Matset {
-  키: string;
-  이름: string;
-  담은자재: MatItem[];
-  /** 본뜬 원본 자재 조합 키 — 비면 원본 */
-  본뜬키: string | null;
-  소유: string | null;
-  비고: string | null;
-}
-export interface MatsetSummary extends Omit<Matset, "담은자재"> {
-  count: number;
-}
-export interface MatsetOne {
-  file: string;
-  version: string;
-  matset: Matset;
-}
-
-async function request<T>(path: string, body?: unknown): Promise<T> {
-  const response = await fetch(`${API_BASE_URL}/m01${path}`, {
-    method: body === undefined ? "GET" : "POST",
-    credentials: "include",
-    headers: { "Content-Type": "application/json" },
-    body: body === undefined ? undefined : JSON.stringify(body),
-  });
-  const data = (await response.json().catch(() => ({}))) as { detail?: unknown } & T;
-  if (!response.ok) throw new ApiError(response.status, data.detail ?? response.statusText);
-  return data;
-}
-
-export const fetchMatsets = (): Promise<MatsetSummary[]> =>
-  request<{ matsets: MatsetSummary[] }>("/matsets").then((d) => d.matsets);
-
-export const fetchMatset = (key: string): Promise<MatsetOne> =>
-  request(`/matset?key=${encodeURIComponent(key)}`);
-
-export const newMatset = (matset: Matset): Promise<{ key: string; version: string }> =>
-  request("/matset/new", { matset });
-
-export const editMatset = (key: string, version: string, matset: Matset): Promise<unknown> =>
-  request("/matset/edit", { key, version, matset });
-
-export const deleteMatset = (key: string, version: string): Promise<unknown> =>
-  request("/matset/delete", { key, version });

M01_MasterData/M01_MasterData_UI_Matset_Text.ts

@@ -1,59 +0,0 @@
-/* =============================================================================
- * M01_MasterData_UI_Matset_Text.ts
- * 자재 조합 화면 글자 — [한국어, 영어]
- * ========================================================================== */
-
-import { currentLanguageIndex } from "@ui/ui_template_locale";
-
-const TEXT = {
-  Title: ["자재 조합", "Material set"],
-  Search: ["이름 · 키로 찾기", "Search by name or key"],
-  Empty: [
-    "자재 조합이 없음 — [새 자재 조합]으로 만듦",
-    "No material sets — press [New material set]",
-  ],
-  New: ["새 자재 조합", "New material set"],
-  Delete: ["지우기", "Delete"],
-  Save: ["저장", "Save"],
-  DeleteAsk: ["이 자재 조합을 지울까요?", "Delete this material set?"],
-  Saved: ["저장함", "Saved"],
-  Deleted: ["지움", "Deleted"],
-  Stale: ["그 사이 자재 조합 파일이 바뀜 — 다시 열어 주세요", "The file changed — reopen it"],
-  Loading: ["불러오는 중…", "Loading…"],
-  NeedName: ["이름을 적어야 저장됨", "A name is required"],
-  NeedItem: ["담은 자재가 하나는 있어야 저장됨", "Add at least one material"],
-  Load_Failed: ["불러오지 못함", "Load failed"],
-  Head_Key: ["키", "Key"],
-  Head_Name: ["이름", "Name"],
-  Head_Count: ["자재 수", "Materials"],
-  Head_Origin: ["본뜬키", "Copied from"],
-  Head_Owner: ["소유", "Owner"],
-  Head_Note: ["비고", "Note"],
-  Origin_Self: ["원본", "Original"],
-  Items_Title: ["담은 자재", "Materials in it"],
-  Col_Code: ["자재 코드", "Code"],
-  Col_Name: ["이름", "Name"],
-  Col_Spec: ["규격", "Spec"],
-  Col_Unit: ["단위", "Unit"],
-  Col_Move: ["빼기", "Remove"],
-  Remove: ["빼기", "Remove"],
-  AddItem: ["자재 더하기", "Add material"],
-  NoItem: ["담은 자재 없음", "No materials yet"],
-  Pick_Title: ["자재 고르기", "Pick a material"],
-  Pick_Search: ["이름 · 규격으로 찾기", "Search by name or spec"],
-  Pick_Find: ["찾기", "Find"],
-  Pick_Hint: [
-    "낱말을 적고 [찾기]를 누름 — 하나씩 직접 고름",
-    "Type words, press Find — pick one by one",
-  ],
-  Pick_None: ["찾은 자재 없음", "No materials found"],
-  Pick_Have: ["이미 담음", "Already in"],
-  Pick_Close: ["닫기", "Close"],
-} as const satisfies Record<string, readonly [string, string]>;
-
-export type MatsetTextKey = keyof typeof TEXT;
-
-export function tm(key: MatsetTextKey): string {
-  const entry = TEXT[key];
-  return entry[currentLanguageIndex as 0 | 1] ?? entry[0];
-}

M01_MasterData/M01_MasterData_UI_Page.ts

@@ -39,7 +39,6 @@ import { tl } from "./M01_MasterData_UI_LogicLab_Text";
 import { renderTables } from "./M01_MasterData_UI_Tables";
 import type { LogicHandle } from "./M01_MasterData_UI_LogicLab";
 import type { ComboHandle } from "./M01_MasterData_UI_Combo";
-import type { MatsetHandle } from "./M01_MasterData_UI_Matset";
 import "./M01_MasterData_UI_Style.css";
 
 const TABLE_GROUPS = ["소요량", "계수"];
@@ -61,7 +60,6 @@ function buildPage(): HTMLElement {
   let dispose = (): void => {};
   let logicMounted = false;
   let comboHandle: ComboHandle | null = null;
-  let matsetHandle: MatsetHandle | null = null;
 
   /* --- 우측: 머리(제목·찾기·저장) + 알림 + 본문 --- */
   const title = el("h2", { className: "m01-master__title", text: L("M01_PickFile") });
@@ -78,7 +76,6 @@ function buildPage(): HTMLElement {
   });
   const logicHost = el("div", { className: "m01-master__logic", attrs: { hidden: "" } });
   const comboHost = el("div", { className: "m01-master__logic", attrs: { hidden: "" } });
-  const matsetHost = el("div", { className: "m01-master__logic", attrs: { hidden: "" } });
   const elementView = el("div", {
     className: "m01-master__elements",
     children: [
@@ -101,10 +98,9 @@ function buildPage(): HTMLElement {
   onDraftChange(refreshBar);
   refreshBar();
 
-  const showMode = (mode: "elements" | "logic" | "combo" | "matset"): void => {
+  const showMode = (mode: "elements" | "logic" | "combo"): void => {
     logicHost.hidden = mode !== "logic";
     comboHost.hidden = mode !== "combo";
-    matsetHost.hidden = mode !== "matset";
     elementView.hidden = mode !== "elements";
   };
 
@@ -226,22 +222,6 @@ function buildPage(): HTMLElement {
     });
   };
 
-  /** 「자재 조합」 — 목록을 새로 받아 그림 */
-  const openMatsetTab = (): void => {
-    dispose();
-    dispose = (): void => {};
-    current = null;
-    showMode("matset");
-    if (matsetHandle) {
-      void matsetHandle.show();
-      return;
-    }
-    void import("./M01_MasterData_UI_Matset").then((m) => {
-      matsetHandle = m.mountM01Matset(matsetHost, side);
-      void matsetHandle.show();
-    });
-  };
-
   /** 알약 → 마스터 화면 — 찾기 글을 그 키로 두고 열고, 알림줄에 「단가산출 로직으로 돌아가기」를 둠 */
   const jump = async (target: MasterJump): Promise<void> => {
     let group = target.kind === "element" ? target.group : "";
@@ -282,7 +262,7 @@ function buildPage(): HTMLElement {
   setMasterJump((target) => void jump(target));
 
   /* --- 좌측: 컨테이너 --- */
-  const side = buildSide(openFile, () => openLogicTab(), openComboTab, openMatsetTab);
+  const side = buildSide(openFile, () => openLogicTab(), openComboTab);
 
   const layout = el("div", { className: "ui-workflow-layout m01-master" });
   const main = el("main", {
@@ -290,7 +270,7 @@ function buildPage(): HTMLElement {
     children: [
       el("div", {
         className: "m01-master__panel",
-        children: [elementView, logicHost, comboHost, matsetHost],
+        children: [elementView, logicHost, comboHost],
       }),
     ],
   });

M01_MasterData/M01_MasterData_UI_Side.ts

@@ -11,7 +11,6 @@ import { t as L } from "@ui/ui_template_locale";
 import { fetchFiles, fetchSubsAll, type FileInfo, type SubInfo } from "./M01_MasterData_Api_Fetch";
 import { tx } from "./M01_MasterData_UI_Logic_Text";
 import { tc } from "./M01_MasterData_UI_Combo_Text";
-import { tm } from "./M01_MasterData_UI_Matset_Text";
 import { renderTree, type MakeRow } from "./M01_MasterData_UI_Tree";
 
 /** 컨테이너마다 기억하는 화면 상태 — 찾기 글 · 쪽 · 소요량·계수 표의 용도 대상 거름 (거름은 `m01.filter.*`) */
@@ -89,8 +88,6 @@ export interface SideHandle {
   logicHost: HTMLElement;
   /** 일위대가 조합 컨테이너 안(구분 · 상세구분 거름이 들어갈 자리) */
   comboHost: HTMLElement;
-  /** 자재 조합 컨테이너 안(찾기 칸이 들어갈 자리) */
-  matsetHost: HTMLElement;
   /** 그룹의 파일 판본을 다시 받음(저장 뒤) — 돌려받는 것 = 새 목록 */
   refresh: (group: string) => Promise<FileInfo[]>;
   /** 그룹의 파일 목록(이미 받은 것) */
@@ -149,13 +146,11 @@ const LEAF: Group[] = ["환율", "요율"];
 const FILTERED: Group[] = ["인력", "기계", "소요량", "계수"];
 const LOGIC_ID = "로직|";
 const COMBO_ID = "조합|";
-const MATSET_ID = "자재조합|";
 
 export function buildSide(
   onOpen: (pick: Pick) => void,
   onLogic: () => void,
   onCombo: () => void = () => {},
-  onMatset: () => void = () => {},
 ): SideHandle {
   const lists = new Map<Group, FileInfo[]>();
   const bodies = new Map<Group, HTMLElement>();
@@ -465,17 +460,9 @@ ${first.file}`
     onCombo();
   });
 
-  const matsetHost = el("div", { className: "m01-side__items ui-sidebar-list" });
-  const matset = section(tm("Title"), matsetHost);
-  matset.querySelector(".ui-collapsible__title")?.addEventListener("click", () => {
-    if (!matset.classList.contains("is-collapsed")) return;
-    setActive(buttons.has(MATSET_ID) ? MATSET_ID : null);
-    onMatset();
-  });
-
   const root = el("div", {
     className: "m01-side ui-sidebar-panel",
-    children: [...groups, logic, combo, matset],
+    children: [...groups, logic, combo],
   });
   attachCollapsible(root);
   void Promise.all(GROUPS.map(refresh)).catch((error) =>
@@ -485,5 +472,5 @@ ${first.file}`
     onPicked = fn;
   };
   const files = (group: string): FileInfo[] => lists.get(group as Group) ?? [];
-  return { root, logicHost, comboHost, matsetHost, refresh, files, setActive, setOnPicked, filter };
+  return { root, logicHost, comboHost, refresh, files, setActive, setOnPicked, filter };
 }

M02_MasterTemplete/M02_MasterTemplete_Api_Fetch.ts

@@ -36,11 +36,14 @@ async function call<T>(path: string, init: RequestInit = {}): Promise<T> {
     ...init,
   });
   const body = (await response.json().catch(() => ({}))) as { detail?: unknown } & T;
-  if (response.status === 409)
+  // 서버 까닭 목록(`{errors: [...]}` — 422 검사 걸림 · 409 쓰는 곳 있어 못 지움)은 글로
+  const errors = (body.detail as { errors?: unknown } | null)?.errors;
+  const said = Array.isArray(errors) ? errors.join(" / ") : "";
+  if (response.status === 409 && !said)
     throw new StaleError(typeof body.detail === "string" ? body.detail : "409");
   if (!response.ok) {
     const detail = body.detail;
-    throw new Error(typeof detail === "string" ? detail : `HTTP ${response.status}`);
+    throw new Error(said || (typeof detail === "string" ? detail : `HTTP ${response.status}`));
   }
   return body;
 }
@@ -208,6 +211,33 @@ export const branchMaterialCombo = (
     body: JSON.stringify(body),
   });
 
+/* --- 자재 조합 표(마스터 템플릿 `자재조합.json`) — 좌측 「자재 조합」 컨테이너 --- */
+/** 표 통째 — 판(파일 판본) · 줄(담은 자재 포함) · 쓰는곳(키 → 쓰는 구조물 열 이름들) */
+export const listMaterialCombos = (): Promise<{
+  판: string;
+  줄: MaterialCombo[];
+  쓰는곳: Record<string, string[]>;
+}> => call("/material-combos");
+
+/** 새로 · 본떠 만들기(`본뜬키`) — 키는 서버가 표 「다음」 번호로 줌 */
+export const createMaterialCombo = (
+  판: string,
+  줄: Omit<MaterialCombo, "키">,
+): Promise<{ 키: string; 판: string; 줄: MaterialCombo }> =>
+  call("/material-combos", { method: "POST", body: JSON.stringify({ 판, 줄 }) });
+
+/** 고치기 — 이름 · 비고 · 담은자재(본뜬키 · 소유는 서버가 있던 것으로) */
+export const editMaterialCombo = (
+  키: string,
+  판: string,
+  줄: MaterialCombo,
+): Promise<{ 키: string; 판: string; 줄: MaterialCombo }> =>
+  call(`/material-combos/${enc(키)}`, { method: "PUT", body: JSON.stringify({ 판, 줄 }) });
+
+/** 지우기 — 구조물 열이 쓰면 서버가 막고 그 열 이름들을 까닭으로 줌 */
+export const deleteMaterialCombo = (키: string, 판: string): Promise<unknown> =>
+  call(`/material-combos/${enc(키)}?판=${enc(판)}`, { method: "DELETE" });
+
 /** 다른 열(`from`) 구조물 도면 내용을 받는 열(`column`)로 가져옴 — 도번 · 열은 받는 쪽 그대로 */
 export const copyStructure = async (column: string, from: string): Promise<void> => {
   await call(`/structures/${enc(column)}/copy?from=${enc(from)}`, { method: "POST" });

M02_MasterTemplete/M02_MasterTemplete_Branch.py

@@ -1,7 +1,7 @@
 """조합 갈라 내기 — 구조물 열 하나가 가리키는 조합을 고친 내용으로 새로 만들어 그 열만 새 키를
 가리키게 함(PLAN 15장 · 검토 `14_조합편집검토.md` 1장).
   · 일위대가 조합(UA · `일위대가조합.json`) — 새 줄은 M01 조합 저장소가 만듦(부르기만)
-  · 자재 조합(UM · `자재조합.json`) — M01 마스터 저장(`save`)으로 더함(키 = 대장 다음 번호)
+  · 자재 조합(UM · 마스터 템플릿 `자재조합.json`) — M02 자재 조합 저장소가 만듦(표 「다음」 번호)
 
 조합은 여러 열 · 모든 프로젝트가 같이 씀 — 제자리 고치지 않음. 담은 것의 집합(차례 · 메모 무시)이
 이미 있는 조합과 같으면 새로 안 만들고 그 키 · 새 줄의 본뜬키 = 원래 키 · 소유 현장.
@@ -13,10 +13,10 @@ from typing import Any, Callable
 
 from M01_MasterData import M01_MasterData_Store as m01
 from M01_MasterData import M01_MasterData_Store_Combo as combo_store
+from M02_MasterTemplete import M02_MasterTemplete_Matset as matset
 from M02_MasterTemplete import M02_MasterTemplete_Store as store
 
 _OWNER = "현장"
-MATERIAL_FILE = "자재조합.json"
 
 
 def _m01(fn, *args):
@@ -39,7 +39,7 @@ def _branch(
     column: str,
     version: str,
     field: str,
-    file: str,
+    rows: list[dict],
     slot: str,
     ident: str,
     items: list[dict],
@@ -61,7 +61,6 @@ def _branch(
     def body(got) -> frozenset[str]:
         return frozenset(str(x.get(ident) or "") for x in got or [] if isinstance(x, dict))
 
-    rows = _m01(m01.read, file)[0].get("줄") or []
     same = [r for r in rows if body(r.get(slot)) == body(items)]
     hit = next((r for r in same if source and r.get("키") == source), same[0] if same else None)
     if hit:
@@ -101,20 +100,12 @@ def branch_combo(
         return str(_m01(combo_store.combo_new, row, _OWNER)["key"])
 
     name = name.strip() or str(was.get("이름") or source)
-    return _branch(
-        column, version, "일위대가", combo_store.FILE, "담은로직", "로직", items, source, make, name
-    )
-
-
-def _material_rows() -> list[dict]:
-    return _m01(m01.read, MATERIAL_FILE)[0].get("줄") or []
+    rows = _m01(m01.read, combo_store.FILE)[0].get("줄") or []
+    return _branch(column, version, "일위대가", rows, "담은로직", "로직", items, source, make, name)
 
 
 def material_combo(key: str) -> dict[str, Any]:
-    row = next((r for r in _material_rows() if r.get("키") == key), None)
-    if row is None:
-        raise store.StoreError(404, f"없는 자재 조합 「{key}」")
-    return row
+    return matset.one(key)
 
 
 def branch_material_combo(
@@ -128,24 +119,12 @@ def branch_material_combo(
         if isinstance(x, dict)
     ]
 
-    def make(made_name: str, rows: list[dict]) -> str:
+    def make(made_name: str, _rows) -> str:
         row = {"이름": made_name, "담은자재": items, "본뜬키": source or None, "소유": _OWNER}
-        before = {r.get("키") for r in rows}
-        _m01(
-            m01.save,
-            [
-                {
-                    "file": MATERIAL_FILE,
-                    "version": _m01(m01.read, MATERIAL_FILE)[1],
-                    "changes": [{"op": "add", "row": {**row, "비고": None}}],
-                }
-            ],
-        )
-        return str(next(r["키"] for r in _material_rows() if r.get("키") not in before))
+        return matset.create(row)["키"]
 
     heads = next((c for c in store._structure_columns() if c["id"] == column), {})
     default = " ".join(h for h in store._heads(heads) if h) if heads else column
     name = name.strip() or str(was.get("이름") or default or column)
-    return _branch(
-        column, version, "자재조합", MATERIAL_FILE, "담은자재", "코드", items, source, make, name
-    )
+    rows = matset.listing()["줄"]
+    return _branch(column, version, "자재조합", rows, "담은자재", "코드", items, source, make, name)

M02_MasterTemplete/M02_MasterTemplete_Materials.ts

@@ -118,8 +118,8 @@ export interface MaterialPanelOptions {
   unlink: (codes: string[]) => void;
 }
 
-/** 자재 고르기 창 — 이름 · 규격 · 코드 낱말로 찾아 하나 고름 */
-function pickMaterial(done: (item: MaterialItem) => void): void {
+/** 자재 고르기 창 — 이름 · 규격 · 코드 낱말로 찾아 하나 고름(좌측 자재 조합 상세도 씀) */
+export function pickMaterial(done: (item: MaterialItem) => void): void {
   openModal({
     title: TEXT.pickTitle,
     closeLabel: TEXT.pickClose,

M02_MasterTemplete/M02_MasterTemplete_Matset.py

@@ -0,0 +1,133 @@
+"""M02 자재 조합 저장소 — 마스터 템플릿 표 `자재조합.json`(구조물집계표조합.json 과 같은 자리).
+
+줄 = 키 UM · 이름 · 담은자재(코드 · 이름 · 규격 · 단위) · 본뜬키 · 소유 · 비고 — 수량 · 단가는 안 둠
+(재료산출 몫). 키는 표 안 「다음」 번호(지운 키는 다시 안 씀) · 집계표 열 `자재조합` 칸이 가리킴.
+틀 검사 = `master_material_combo.check_form`(check_master 와 같은 것) · 판 = 파일 sha256 앞 16자.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+from common_util.common_util_json import atomic_write_json
+from M01_MasterData import M01_MasterData_Store as m01
+from M02_MasterTemplete import M02_MasterTemplete_Store as store
+
+mmc = m01.cm.mmc  # 자재 조합 틀(`resources/master_data/scripts/master_material_combo.py`)
+FILE = mmc.FILE
+OWNERS = mmc.OWNERS
+_HEAD = "UM"
+
+
+def _load() -> tuple[dict[str, Any], str]:
+    """(표, 판) — 파일이 없으면 빈 표 · 판 빈 글."""
+    path = store.FOLDER / FILE
+    if not path.is_file():
+        return {"그룹": mmc.GROUP, "판": "2026", "비고": [], "다음": 1, "줄": []}, ""
+    raw = path.read_bytes()
+    return json.loads(raw), store.version_of(raw)
+
+
+def _find(doc: dict, key: str) -> dict[str, Any]:
+    row = next((r for r in doc["줄"] if r.get("키") == key), None)
+    if row is None:
+        raise store.StoreError(404, f"없는 자재 조합 「{key}」")
+    return row
+
+
+def listing() -> dict[str, Any]:
+    """표 통째 — 판 · 줄(담은 자재 포함 · 작아서 한 번에) · 쓰는곳(키 → 쓰는 구조물 열 이름들)."""
+    doc, version = _load()
+    used: dict[str, list[str]] = {}
+    for col in store._structure_columns():
+        if key := col.get("자재조합"):
+            used.setdefault(key, []).append(_name(col))
+    return {"판": version, "줄": doc["줄"], "쓰는곳": used}
+
+
+def _name(col: dict) -> str:
+    return " ".join(h for h in store._heads(col) if h) or col["id"]
+
+
+def one(key: str) -> dict[str, Any]:
+    return _find(_load()[0], key)
+
+
+def users_of(key: str) -> list[str]:
+    """구조물집계표에서 `자재조합` 칸이 이 키인 열 — 머리 글(없으면 열 id)."""
+    out = []
+    for col in store._structure_columns():
+        if col.get("자재조합") == key:
+            out.append(_name(col))
+    return out
+
+
+def _clean(row: Any, key: str, keep: dict | None = None) -> dict[str, Any]:
+    """서버가 잡는 칸 — 키 · 열 한 벌 · 자재 줄 네 칸 · 본뜬키는 만들 때만(고칠 때는 있던 것)."""
+    if not isinstance(row, dict):
+        raise store.StoreError(400, "자재 조합 줄이 묶음 아님")
+    name = row.get("이름")
+    if not isinstance(name, str) or not name.strip():
+        raise store.StoreError(400, "자재 조합 줄에 「이름」 이 없거나 글자 아님")
+    got = row.get("담은자재")
+    got = [
+        {c: m.get(c) for c in mmc.ITEM_COLS} if isinstance(m, dict) else m
+        for m in (got if isinstance(got, list) else [])
+    ]
+    known = {str(r.get("키")) for d in m01.loaded()[0].values() for r in d.get("줄") or []}
+    lost = [str(m.get("코드")) for m in got if isinstance(m, dict) and m.get("코드") not in known]
+    if lost:
+        raise store.StoreError(422, {"errors": [f"마스터에 없는 자재 {' · '.join(lost)}"]})
+    base = keep or row
+    owner = base.get("소유") or OWNERS[0]
+    return {
+        "키": key,
+        "이름": name.strip(),
+        "담은자재": got,
+        "본뜬키": base.get("본뜬키") or None,
+        "소유": owner,
+        "비고": row.get("비고") or None,
+    }
+
+
+def _save(doc: dict, version: str) -> str:
+    """틀 검사 → 판이 같을 때만 씀 → 새 판."""
+    if errors := mmc.check_form(FILE, doc):
+        raise store.StoreError(422, {"errors": errors})
+    path = store.FOLDER / FILE
+    with store._LOCK:
+        have = store.version_of(path.read_bytes()) if path.is_file() else ""
+        if have != (version or ""):
+            raise store.StoreError(409, {"stale": [FILE], "판": have})
+        atomic_write_json(path, doc)
+        return store.version_of(path.read_bytes())
+
+
+def create(row: Any, version: str | None = None) -> dict[str, Any]:
+    """새 줄 — 키 = 「다음」 번호 · 본뜬키는 있는 다른 키만. `version` None = 지금 판(갈라 내기)."""
+    doc, have = _load()
+    key = f"{_HEAD}{int(doc.get('다음') or 1):06d}"
+    fixed = _clean(row, key)
+    if fixed["본뜬키"] and fixed["본뜬키"] not in {r.get("키") for r in doc["줄"]}:
+        raise store.StoreError(400, f"본뜬키 「{fixed['본뜬키']}」 — 있는 다른 자재 조합 키여야 함")
+    doc = {**doc, "다음": int(doc.get("다음") or 1) + 1, "줄": [*doc["줄"], fixed]}
+    return {"키": key, "판": _save(doc, have if version is None else version), "줄": fixed}
+
+
+def edit(key: str, row: Any, version: str) -> dict[str, Any]:
+    doc, _ = _load()
+    fixed = _clean(row, key, keep=_find(doc, key))
+    doc = {**doc, "줄": [fixed if r.get("키") == key else r for r in doc["줄"]]}
+    return {"키": key, "판": _save(doc, version), "줄": fixed}
+
+
+def delete(key: str, version: str) -> dict[str, Any]:
+    """지우기 — 구조물 열이 쓰면 409 + 열 이름들(지우지 않음)."""
+    doc, _ = _load()
+    _find(doc, key)
+    if users := users_of(key):
+        msg = f"구조물 {len(users)} 곳이 쓰는 자재 조합이라 못 지움 — {' · '.join(users)}"
+        raise store.StoreError(409, {"errors": [msg], "users": users})
+    doc = {**doc, "줄": [r for r in doc["줄"] if r.get("키") != key]}
+    return {"판": _save(doc, version)}

M02_MasterTemplete/M02_MasterTemplete_Matset.ts

@@ -0,0 +1,264 @@
+/* =============================================================================
+ * M02_MasterTemplete_Matset.ts
+ * 좌측 「자재 조합」 컨테이너 — 찾기 · 목록(키 맨 앞) · 새로 · 본떠 만들기 · 지우기(컨테이너 안) ·
+ * 줄을 누르면 메인 칸에 상세: 이름 · 비고 · 본뜬키 · 담은 자재 표(빼기) · [자재 더하기] · [저장].
+ * 표 = 마스터 템플릿 `자재조합.json`(키 UM · 서버 `M02_MasterTemplete_Matset.py`) · 지우기는 쓰는 열이
+ * 있으면 서버가 막음. 재료산출 옆 판이 갈라 낸 조합도 같은 표라 여기 보임(펼칠 때 새로 받음).
+ * ========================================================================== */
+
+import {
+  createButton,
+  createInputField,
+  el,
+  showConfirmDialog,
+  showToast,
+} from "@ui/ui_template_elements";
+import { t as L } from "@ui/ui_template_locale";
+import {
+  createMaterialCombo,
+  deleteMaterialCombo,
+  editMaterialCombo,
+  listMaterialCombos,
+  StaleError,
+  type MaterialCombo,
+} from "./M02_MasterTemplete_Api_Fetch";
+import { pickMaterial } from "./M02_MasterTemplete_Materials";
+import { tm } from "./M02_MasterTemplete_Matset_Text";
+
+export interface MatsetSectionOptions {
+  isAdmin: boolean;
+  /** 저장 안 한 고침을 버릴지 확인 — 취소면 false */
+  confirmLeave: () => Promise<boolean>;
+  /** 메인 칸에 상세를 띄움 — 고침 표시 손잡이를 돌려받음 */
+  show: (label: string, node: HTMLElement) => (dirty: boolean) => void;
+  /** 메인 칸을 비움(지운 뒤) */
+  close: () => void;
+  /** 상세를 열었음 — 좌측 다른 줄 고름 표시를 지움 */
+  onOpen: () => void;
+}
+
+export interface MatsetSection {
+  title: string;
+  body: HTMLElement;
+  /** 새로 · 본떠 만들기 · 지우기 줄(관리자만 · 아니면 빈 목록) */
+  actions: HTMLElement[];
+  /** 표를 새로 받아 목록을 다시 그림 */
+  refresh: () => Promise<void>;
+  /** 다른 양식을 열었음 — 고름 표시만 지움 */
+  clear: () => void;
+}
+
+const why = (error: unknown): string => (error instanceof Error ? error.message : "");
+
+export function buildMatsetSection(opt: MatsetSectionOptions): MatsetSection {
+  let all: MaterialCombo[] = [];
+  let version = "";
+  let used: Record<string, string[]> = {};
+  let q = "";
+  /** 열린 상세의 키 — 새(저장 전)는 빈 글 · 안 열렸으면 null */
+  let openKey: string | null = null;
+
+  const find = createInputField({ type: "search", placeholder: tm("Search") });
+  const list = el("div", { className: "m02-side__items ui-sidebar-list" });
+  const body = el("div", { className: "m02-side__items", children: [find.root, list] });
+  find.input.addEventListener("input", () => {
+    q = find.input.value.trim().toLowerCase();
+    paintList();
+  });
+
+  const btnNew = createButton({ label: L("M02_New"), variant: "filled", size: "sm" });
+  const btnCopy = createButton({ label: L("M02_Copy"), variant: "ghost", size: "sm" });
+  const btnDel = createButton({ label: L("M02_Delete"), variant: "danger", size: "sm" });
+  const actions = opt.isAdmin
+    ? [el("div", { className: "m02-side__row", children: [btnNew, btnCopy, btnDel] })]
+    : [];
+  const paintButtons = (): void => {
+    btnCopy.disabled = btnDel.disabled = !openKey;
+  };
+
+  function paintList(): void {
+    const shown = all.filter((x) => !q || `${x.키} ${x.이름}`.toLowerCase().includes(q));
+    list.replaceChildren(
+      ...(shown.length
+        ? shown.map((x) => {
+            const b = el("button", {
+              className: `m02-side__item ui-sidebar-row${x.키 === openKey ? " is-active" : ""}`,
+              text: `${x.키} ${x.이름}`,
+              attrs: { type: "button", "data-matset-key": x.키 },
+            });
+            b.addEventListener("click", () => void select(x.키));
+            return b;
+          })
+        : [el("p", { className: "m02-side__empty", text: tm("Empty") })]),
+    );
+  }
+
+  async function refresh(): Promise<void> {
+    try {
+      ({ 판: version, 줄: all, 쓰는곳: used } = await listMaterialCombos());
+    } catch (error) {
+      showToast(tm("Load_Failed", why(error)), "error");
+    }
+    paintList();
+    paintButtons();
+  }
+
+  async function select(key: string): Promise<void> {
+    if (key === openKey || !(await opt.confirmLeave())) return;
+    const row = all.find((x) => x.키 === key);
+    if (row) draw(structuredClone(row), false);
+  }
+
+  /** 메인 칸 상세 — `row` 는 고칠 사본(저장 전까지 표에 안 들어감) */
+  function draw(row: MaterialCombo, isNew: boolean): void {
+    openKey = isNew ? "" : row.키;
+    const edit = opt.isAdmin;
+    const field = (label: string, name: "이름" | "비고") => {
+      const f = createInputField({ type: "text", label });
+      f.input.value = row[name] ?? "";
+      f.input.disabled = !edit;
+      f.input.setAttribute("data-matset-field", name);
+      f.input.addEventListener("input", () => {
+        if (name === "이름") row.이름 = f.input.value;
+        else row.비고 = f.input.value || null;
+        setDirty(true);
+      });
+      return f.root;
+    };
+    const table = el("div", { className: "m02-matset__table" });
+    const paintItems = (): void => {
+      const head = el("div", {
+        className: "m02-mat__row m02-mat__row--head",
+        children: [tm("Col_Code"), tm("Col_Name"), tm("Col_Spec"), tm("Col_Unit"), "", ""].map(
+          (t) => el("span", { text: t }),
+        ),
+      });
+      const rows = row.담은자재.map((m, i) => {
+        const acts = el("span");
+        if (edit) {
+          const del = createButton({ label: tm("Remove"), variant: "ghost", size: "sm" });
+          del.addEventListener("click", () => {
+            row.담은자재.splice(i, 1);
+            setDirty(true);
+            paintItems();
+          });
+          acts.append(del);
+        }
+        return el("div", {
+          className: "m02-mat__row",
+          attrs: { "data-matset-item": m.코드 },
+          children: [m.코드, m.이름 ?? "", m.규격 ?? "", m.단위 ?? "", ""]
+            .map((t) => el("span", { text: t }))
+            .concat(acts),
+        });
+      });
+      table.replaceChildren(
+        head,
+        ...(rows.length ? rows : [el("p", { className: "m02-side__empty", text: tm("NoItem") })]),
+      );
+    };
+    paintItems();
+
+    const add = createButton({ label: tm("AddItem"), variant: "ghost" });
+    add.addEventListener("click", () =>
+      pickMaterial((m) => {
+        if (row.담은자재.some((x) => x.코드 === m.코드)) return;
+        row.담은자재.push({ 코드: m.코드, 이름: m.이름, 규격: m.규격, 단위: m.단위 });
+        setDirty(true);
+        paintItems();
+      }),
+    );
+    const save = createButton({ label: tm("Save"), variant: "filled" });
+    save.addEventListener("click", async () => {
+      if (!row.이름.trim()) return showToast(tm("NeedName"), "error");
+      if (!row.담은자재.length) return showToast(tm("NeedItem"), "error");
+      save.disabled = true; // 연달아 눌러도 한 번만
+      try {
+        const { 키, ...rest } = row;
+        const done = isNew
+          ? await createMaterialCombo(version, rest)
+          : await editMaterialCombo(키, version, row);
+        setDirty(false);
+        showToast(tm("Saved"), "success");
+        await refresh();
+        draw(structuredClone(done.줄), false);
+      } catch (error) {
+        if (error instanceof StaleError) {
+          showToast(tm("Stale"), "error");
+          await refresh();
+        } else showToast(tm("Failed", why(error)), "error");
+      } finally {
+        save.disabled = false;
+      }
+    });
+
+    const node = el("div", {
+      className: "m02-matset",
+      children: [
+        el("div", {
+          className: "m02-matset__fields",
+          children: [
+            field(tm("Head_Name"), "이름"),
+            field(tm("Head_Note"), "비고"),
+            el("p", {
+              className: "m02-side__empty",
+              text: `${tm("Head_Origin")}: ${row.본뜬키 ?? tm("Origin_Self")}`,
+              attrs: { "data-matset-origin": row.본뜬키 ?? "" },
+            }),
+          ],
+        }),
+        el("h3", { className: "m02-matset__head", text: tm("Items_Title") }),
+        table,
+        ...(edit ? [el("div", { className: "m02-side__row", children: [add, save] })] : []),
+      ],
+    });
+    const setDirty = opt.show(isNew ? tm("New") : `${row.키} ${row.이름}`, node);
+    if (isNew) setDirty(true);
+    opt.onOpen();
+    paintList();
+    paintButtons();
+  }
+
+  btnNew.addEventListener("click", async () => {
+    if (!(await opt.confirmLeave())) return;
+    draw({ 키: "", 이름: "", 담은자재: [], 본뜬키: null, 소유: "현장", 비고: null }, true);
+  });
+  btnCopy.addEventListener("click", async () => {
+    const from = all.find((x) => x.키 === openKey);
+    if (!from || !(await opt.confirmLeave())) return;
+    const copy = structuredClone(from);
+    draw({ ...copy, 키: "", 이름: tm("CopyName", from.이름), 본뜬키: from.키, 소유: "현장" }, true);
+  });
+  btnDel.addEventListener("click", async () => {
+    const key = openKey;
+    if (!key) return;
+    await refresh(); // 최신 판 · 쓰는 열로
+    // 쓰는 열이 있으면 확인 창 없이 바로 알림(서버도 막음)
+    const users = used[key] ?? [];
+    if (users.length) return showToast(tm("InUse", users.join(" · ")), "error");
+    if (!(await showConfirmDialog(tm("DeleteAsk", key)))) return;
+    try {
+      await deleteMaterialCombo(key, version);
+      showToast(tm("Deleted"), "success");
+      openKey = null;
+      opt.close();
+    } catch (error) {
+      showToast(tm("Failed", why(error)), "error");
+    }
+    await refresh();
+  });
+
+  paintButtons();
+  return {
+    title: tm("Title"),
+    body,
+    actions,
+    refresh,
+    clear: () => {
+      if (openKey === null) return;
+      openKey = null;
+      paintList();
+      paintButtons();
+    },
+  };
+}

M02_MasterTemplete/M02_MasterTemplete_Matset_Text.ts

@@ -0,0 +1,49 @@
+/* =============================================================================
+ * M02_MasterTemplete_Matset_Text.ts
+ * 좌측 「자재 조합」 컨테이너 · 상세 화면 글자 — [한국어, 영어]
+ * ========================================================================== */
+
+import { currentLanguageIndex } from "@ui/ui_template_locale";
+
+const TEXT = {
+  Title: ["자재 조합", "Material sets"],
+  Search: ["키 · 이름으로 찾기", "Search by key or name"],
+  Empty: ["자재 조합 없음", "No material sets"],
+  New: ["새 자재 조합(저장 전)", "New material set (unsaved)"],
+  CopyName: ["{value} 본뜸", "{value} copy"],
+  Save: ["저장", "Save"],
+  InUse: [
+    "{value} 열이 쓰는 자재 조합이라 못 지움",
+    "Used by the column(s) {value} — cannot delete",
+  ],
+  DeleteAsk: ["자재 조합 {value} 을 지울까요?", "Delete material set {value}?"],
+  Saved: ["저장함", "Saved"],
+  Deleted: ["지움", "Deleted"],
+  Stale: [
+    "그 사이 자재 조합 표가 바뀜 — 목록을 새로 받았으니 다시 고쳐 주세요",
+    "The table changed meanwhile — reloaded, please edit again",
+  ],
+  NeedName: ["이름을 적어야 저장됨", "A name is required"],
+  NeedItem: ["담은 자재가 하나는 있어야 저장됨", "Add at least one material"],
+  Load_Failed: ["자재 조합을 못 받음 — {value}", "Could not load material sets — {value}"],
+  Failed: ["자재 조합을 못 고침 — {value}", "Could not change the material set — {value}"],
+  Head_Name: ["이름", "Name"],
+  Head_Note: ["비고", "Note"],
+  Head_Origin: ["본뜬키", "Copied from"],
+  Origin_Self: ["원본", "Original"],
+  Items_Title: ["담은 자재", "Materials in it"],
+  Col_Code: ["코드", "Code"],
+  Col_Name: ["이름", "Name"],
+  Col_Spec: ["규격", "Spec"],
+  Col_Unit: ["단위", "Unit"],
+  Remove: ["빼기", "Remove"],
+  AddItem: ["자재 더하기", "Add material"],
+  NoItem: ["담은 자재 없음", "No materials yet"],
+} as const satisfies Record<string, readonly [string, string]>;
+
+export type MatsetTextKey = keyof typeof TEXT;
+
+export function tm(key: MatsetTextKey, value = ""): string {
+  const entry = TEXT[key];
+  return (entry[currentLanguageIndex as 0 | 1] ?? entry[0]).replace("{value}", value);
+}

M02_MasterTemplete/M02_MasterTemplete_Router.py

@@ -11,6 +11,7 @@ from fastapi import APIRouter, HTTPException, Query
 from pydantic import BaseModel
 
 from M02_MasterTemplete import M02_MasterTemplete_Branch as branch
+from M02_MasterTemplete import M02_MasterTemplete_Matset as matset
 from M02_MasterTemplete import M02_MasterTemplete_Store as store
 
 router = APIRouter(prefix="/api/m02", tags=["M02 MasterTemplete"])
@@ -35,6 +36,11 @@ class MaterialBranchBody(BaseModel):
     판: str = ""
 
 
+class MatsetBody(BaseModel):
+    판: str = ""  # 자재 조합 표 판 — 어긋나면 409
+    줄: dict[str, Any]
+
+
 def _call(fn, *args):
     try:
         return fn(*args)
@@ -78,12 +84,37 @@ def post_structure_material_combo(column: str, body: MaterialBranchBody) -> dict
     )
 
 
+# 자재 조합 표(마스터 템플릿 `자재조합.json` · 키 UM) — 좌측 「자재 조합」 컨테이너
+@router.get("/material-combos")
+def get_material_combos() -> dict:
+    """표 통째 — `{판, 줄}`(줄마다 담은 자재 포함)."""
+    return _call(matset.listing)
+
+
 @router.get("/material-combos/{key}")
 def get_material_combo(key: str) -> dict:
     """자재 조합 한 줄(키 UM) — 키 · 이름 · 담은자재 · 본뜬키 · 소유 · 비고."""
     return _call(branch.material_combo, key)
 
 
+@router.post("/material-combos")
+def post_material_combo(body: MatsetBody) -> dict:
+    """새로 · 본떠 만들기(`줄.본뜬키`) — 키는 표 「다음」 번호 · `{키, 판, 줄}`."""
+    return _call(matset.create, body.줄, body.판)
+
+
+@router.put("/material-combos/{key}")
+def put_material_combo(key: str, body: MatsetBody) -> dict:
+    """고치기 — 이름 · 비고 · 담은자재(본뜬키 · 소유는 있던 것)."""
+    return _call(matset.edit, key, body.줄, body.판)
+
+
+@router.delete("/material-combos/{key}")
+def delete_material_combo(key: str, 판: str = "") -> dict:
+    """지우기 — 구조물 열이 쓰면 409 `{errors, users}`."""
+    return _call(matset.delete, key, 판)
+
+
 # 복사 가져오기 — 다른 열(`from`) 내용을 받는 열로 · 번호 · 열은 받는 쪽 그대로
 @router.post("/structures/{column}/copy")
 def post_structure_copy(column: str, source: str = Query(alias="from")) -> dict:

M02_MasterTemplete/M02_MasterTemplete_UI_Main.ts

@@ -86,6 +86,8 @@ export interface MainHandle {
   current: () => Selection | null;
   /** 저장 안 한 고침이 있으면 버릴지 물음 — 취소면 false */
   confirmLeave: () => Promise<boolean>;
+  /** 양식 밖 화면(좌측 자재 조합 상세)을 띄움 — 머리는 제목만 · 고침 표시 손잡이를 돌려줌 */
+  showView: (label: string, node: HTMLElement) => (dirty: boolean) => void;
 }
 
 /** 이 층에서 고칠 수 있나 — 시스템은 관리자만 · 회사는 여기서 못 고침(공식으로 저장으로만) */
@@ -429,11 +431,23 @@ export function createMain(isAdmin: boolean, onSaved?: () => void): MainHandle {
     }
   }
 
+  function showView(label: string, node: HTMLElement): (d: boolean) => void {
+    ++seq;
+    dirty = false;
+    drop();
+    showNotice([]);
+    sel = null;
+    bar();
+    title.textContent = label;
+    host.replaceChildren(node);
+    return (d) => (dirty = d);
+  }
+
   save.addEventListener("click", () => void doSave());
   reload.addEventListener("click", async () => {
     if (sel && (await confirmLeave())) void open(sel);
   });
   bar();
   empty("");
-  return { root, open, current: () => sel, confirmLeave };
+  return { root, open, current: () => sel, confirmLeave, showView };
 }

M02_MasterTemplete/M02_MasterTemplete_UI_Page.ts

@@ -23,6 +23,7 @@ export async function renderM02MasterTemplate(root: HTMLElement): Promise<void>
     onOpen: (sel) => void main.open(sel),
     getOpen: main.current,
     confirmLeave: main.confirmLeave,
+    showView: main.showView,
   });
 
   const layout = el("div", { className: "ui-workflow-layout m02-master" });

M02_MasterTemplete/M02_MasterTemplete_UI_Side.ts

@@ -3,7 +3,7 @@
  * 마스터 템플릿 좌측 패널 — 시스템 양식 목록(표/도면/구조물 도면/면적산출/재료산출) · 새로 · 본떠 · 지우기.
  * 서버 길은 계약 `6_계약.md`. 구조물 도면 · 면적산출 · 재료산출 줄은 집계표 구조물 열(꼴=수)마다 하나씩 —
  * 서버가 미리 만들어 둠(도번 SD · 면적번 SA · 재료번 SM + 같은 8자리) ·
- * 줄 글은 번호가 맨 앞(「SD01010100 돌기슭막이 …」).
+ * 줄 글은 번호가 맨 앞(「SD01010100 돌기슭막이 …」). 맨 아래 「자재 조합」 컨테이너는 `M02_MasterTemplete_Matset.ts`.
  * ========================================================================== */
 
 import {
@@ -34,6 +34,7 @@ import {
   structureLabel,
   type StructureColumn,
 } from "./M02_MasterTemplete_Structure";
+import { buildMatsetSection } from "./M02_MasterTemplete_Matset";
 import { canEdit, type Selection } from "./M02_MasterTemplete_UI_Main";
 
 const KINDS: { kind: Kind; label: () => string }[] = [
@@ -75,6 +76,8 @@ export interface SideOptions {
   getOpen: () => Selection | null;
   /** 저장 안 한 고침을 버릴지 확인 — 취소면 false */
   confirmLeave: () => Promise<boolean>;
+  /** 메인 칸에 양식 밖 화면(자재 조합 상세)을 띄움 */
+  showView: (label: string, node: HTMLElement) => (dirty: boolean) => void;
 }
 
 export interface SideHandle {
@@ -128,12 +131,30 @@ export function buildSide(opt: SideOptions): SideHandle {
     del.addEventListener("click", () => void deleteCurrent());
     return [el("div", { className: "m02-side__row", children: [btnNew, copy, del] })];
   };
+  const matset = buildMatsetSection({
+    isAdmin: canEdit(layer, opt.isAdmin),
+    confirmLeave: opt.confirmLeave,
+    show: opt.showView,
+    close: () => opt.onOpen(null),
+    onOpen: () => {
+      picked = null;
+      paintList();
+      paintColumns();
+      paintButtons();
+    },
+  });
+  const matsetSection = section(matset.title, matset.body, ...matset.actions);
+  // 펼칠 때마다 새로 받음 — 재료산출 옆 판이 갈라 낸 조합도 바로 보이게
+  matsetSection.querySelector(".ui-collapsible__title")?.addEventListener("click", () => {
+    if (matsetSection.classList.contains("is-collapsed")) void matset.refresh();
+  });
   const listHost = el("div", {
     className: "m02-side__lists ui-sidebar-panel",
     children: [
       section(L("M02_KindTable"), bodies.get("table")!, ...actionRow("table")),
       section(L("M02_KindDrawing"), bodies.get("drawing")!, ...actionRow("drawing")),
       ...COLUMN_KINDS.map((k, i) => section(k.label(), columnBodies[i])),
+      matsetSection,
     ],
   });
   attachCollapsible(listHost);
@@ -202,6 +223,7 @@ export function buildSide(opt: SideOptions): SideHandle {
   async function select(info: TemplateInfo): Promise<void> {
     if (!isOpen(info) && !(await opt.confirmLeave())) return;
     picked = null;
+    matset.clear();
     opt.onOpen({ layer, projectId: null, kind: info.종류, name: info.이름 });
     paintList();
     paintButtons();
@@ -210,6 +232,7 @@ export function buildSide(opt: SideOptions): SideHandle {
   async function selectColumn(col: StructureColumn, kind: ColumnKind): Promise<void> {
     if (!isPicked(kind, col.id) && !(await opt.confirmLeave())) return;
     picked = null;
+    matset.clear();
     // 제목은 편집 화면이 문서 번호를 앞에 붙임(「SD010101 돌기슭막이 …」)
     opt.onOpen({ layer, projectId: null, kind, name: col.id, label: columnHead(col) });
     paintColumns();
@@ -245,7 +268,7 @@ export function buildSide(opt: SideOptions): SideHandle {
     if (mine !== seq) return;
     paintList();
     paintButtons();
-    await refreshStructure();
+    await Promise.all([refreshStructure(), matset.refresh()]);
   }
 
   /* --- 시스템 층 새로 · 본떠 · 지우기(표 · 도면만 — 구조물 도면은 집계표 열이 정함) --- */

M02_MasterTemplete/M02_MasterTemplete_UI_Style.css

@@ -96,3 +96,25 @@
   flex-direction: column;
   gap: var(--spacing-4);
 }
+
+/* 좌측 「자재 조합」 상세(메인 칸) — 이름 · 비고 · 본뜬키 + 담은 자재 표(줄 모양은 재료산출 옆 판 `m02-mat__row`) */
+.m02-matset {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-12);
+  max-width: 56rem;
+  font-size: var(--text-body-sm);
+}
+
+.m02-matset__fields {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-end;
+  gap: var(--spacing-12);
+}
+
+.m02-matset__head {
+  margin: 0;
+  color: var(--color-text);
+  font-size: var(--text-body);
+}

resources/master_data/_키대장.json

@@ -1,5 +1,5 @@
 {
-  "다음": {"LB": 409, "EQ": 655, "RT": 20, "MN": 7000, "MT": 30719, "MO": 74, "MP": 364, "FX": 6, "CF": 159, "QF": 477, "GF": 252, "CC": 341, "GC": 1104, "QC": 2060, "GX": 1, "UA": 38, "UM": 1},
+  "다음": {"LB": 409, "EQ": 655, "RT": 20, "MN": 7000, "MT": 30719, "MO": 74, "MP": 364, "FX": 6, "CF": 159, "QF": 477, "GF": 252, "CC": 341, "GC": 1104, "QC": 2060, "GX": 1, "UA": 38},
   "폐기": {"MT000001": "자재품목 휘발유 — 값이 비고 글뿐 · 유가 테이블로 감", "MT000002": "자재품목 경유 — 값이 비고 글뿐 · 유가 테이블로 감", "MT000003": "자재품목 선박용경유 — 값이 비고 글뿐 · 유가 테이블로 감", "MT000004": "자재품목 중유 — 값이 비고 글뿐 · 유가 테이블로 감", "MT000005": "자재품목 등유 — 값이 비고 글뿐 · 유가 테이블로 감", "LB000399": "이름 「〃」 — 직종이 아니라 되풀이 기호 · 소요량 13-6-9 에서 윗줄 직종으로 바로잡음", "MN": "재료_나라장터자재 — old 로 옮김 · 로직은 자재품목·품셈재료로 갈아 끼움", "LB000372": "미확보 고급기능사 — 측량노임 항공사진고급기능사 옛이름으로 옮김", "LB000393": "미확보 리베팅공 — 건설노임 철골공 옛이름으로 옮김(2010 통합표 연번10)", "LB000405": "미확보 Belt Conveyor 설치공 — 품셈 13-10-1 주② 배분으로 다섯 직종에 나눔", "MT000006": "자재품목 전력 — 재료_유가전력 전력 줄로 감", "MT000007": "자재품목 전력 — 재료_유가전력 전력 줄로 감", "LB000368": "미확보 기술사 — 기술사(건설) 옛이름으로 옮김", "LB000369": "미확보 특급기술자 — 특급기술자(건설) 옛이름으로 옮김", "LB000370": "미확보 고급기술자 — 고급기술자(건설) 옛이름으로 옮김", "LB000361": "미확보 중급기술자 — 중급기술자(건설) 옛이름으로 옮김", "LB000364": "미확보 초급기술자 — 초급기술자(건설) 옛이름으로 옮김", "LB000365": "미확보 고급숙련기술자 — 고급숙련기술자(건설) 옛이름으로 옮김", "LB000366": "미확보 중급숙련기술자 — 중급숙련기술자(건설) 옛이름으로 옮김", "LB000367": "미확보 초급숙련기술자 — 초급숙련기술자(건설) 옛이름으로 옮김", "LB000389": "미확보 기계기사 — 초급기술자(기계·설비) 옛이름으로 옮김", "LB000388": "미확보 기계산업기사 — 초급숙련기술자(기계·설비) 옛이름으로 옮김", "MO000055": {"원문번호": "주택용저압:기본_200이하", "파일": "재료_유가전력.json"}, "MO000056": {"원문번호": "주택용저압:기본_201~400", "파일": "재료_유가전력.json"}, "MO000057": {"원문번호": "주택용저압:기본_400초과", "파일": "재료_유가전력.json"}, "MO000059": {"원문번호": "주택용저압:전력량_다음200", "파일": "재료_유가전력.json"}, "MO000060": {"원문번호": "주택용저압:전력량_400초과", "파일": "재료_유가전력.json"}, "MO000061": {"원문번호": "주택용저압:월간최저요금", "파일": "재료_유가전력.json"}, "MO000062": {"원문번호": "일반용갑I저압:기본", "파일": "재료_유가전력.json"}, "MO000063": {"원문번호": "일반용갑I저압:전력량_여름철", "파일": "재료_유가전력.json"}, "MO000064": {"원문번호": "일반용갑I저압:전력량_봄가을철", "파일": "재료_유가전력.json"}, "MO000065": {"원문번호": "일반용갑I저압:전력량_겨울철", "파일": "재료_유가전력.json"}, "MO000066": {"원문번호": "산업용갑I저압:기본", "파일": "재료_유가전력.json"}, "MO000067": {"원문번호": "산업용갑I저압:전력량_여름철", "파일": "재료_유가전력.json"}, "MO000068": {"원문번호": "산업용갑I저압:전력량_봄가을철", "파일": "재료_유가전력.json"}, "MO000069": {"원문번호": "산업용갑I저압:전력량_겨울철", "파일": "재료_유가전력.json"}, "MO000070": {"원문번호": "임시전력갑:기본요금적용", "파일": "재료_유가전력.json"}, "MO000071": {"원문번호": "임시전력갑:전력량요금적용", "파일": "재료_유가전력.json"}, "MO000072": {"원문번호": "임시전력갑:월간최저요금", "파일": "재료_유가전력.json"}},
   "키": {
     "CC000001": {"원문번호": "공통 1-3-1 콘크리트 및 포장용 재료", "파일": "계수_건설품셈_01장_적용기준.json"},

resources/master_data/_틀.md

@@ -38,7 +38,7 @@
 | MT  | 재료 자재품목 | CF · CC      | 계수 산림 · 건설        |
 | MO  | 재료 유가     | RT           | 요율                    |
 | MP  | 재료 품셈재료(old/ — PLAN 7-4b) | GF · GC · GX | 로직 산림 · 건설 · 자체 |
-| EQ  | 기계          | UA · UM      | 일위대가 조합 · 자재 조합 |
+| EQ  | 기계          | UA           | 일위대가 조합           |
 
 - 빌더는 옛 모양(`열쇠` · 원문별 파일)으로 쓰고 끝에 `scripts/master_keys.py` 의 `adopt` 를 부름 — 키·원문번호·한 테이블·장 파일 이름으로 받음. 옛 이름으로 읽기는 `old_view`.
 
@@ -300,10 +300,10 @@
 
 ## 11. 자재 조합 파일
 
-`자재조합.json` 하나 — 구조물 열 재료산출이 쓰는 **자재 목록 묶음**. 머리 `그룹` · `판` · `비고` · `줄`(원문 없음).
+마스터 템플릿 `resources/master_template/자재조합.json` 하나(이 폴더 밖 · `구조물집계표조합.json` 과 같은 자리) — 구조물 열 재료산출이 쓰는 **자재 목록 묶음**. 머리 `그룹` · `판` · `비고` · `다음` · `줄`(원문 없음). 검사는 `check_master.py 틀` 이 같이 봄(`master_material_combo.check_file`).
 
 - 열 한 벌 — `키` · `이름` · `담은자재` · `본뜬키` · `소유` · `비고`(차례까지 이대로 · 엔진 `scripts/master_material_combo.py`).
-- `키` = `UM` + 6자리 — 대장 `UM` 다음 번호 · 줄에 `원문번호` 를 두지 않음.
+- `키` = `UM` + 6자리 — 표 머리 `다음` 번호(`_키대장` 밖) · 지운 키는 다시 안 씀 · 줄에 `원문번호` 를 두지 않음.
 - `담은자재` 줄 = `{코드, 이름, 규격, 단위}` 뿐 · 빈 목록 안 됨 · 같은 코드 두 번 안 됨 · 수량 · 계산은 두지 않음(재료산출 몫).
 - `본뜬키` = 갈라 낸 원래 자재 조합 키 · 없으면 `null` · `소유` = `현장` · `공용`.
 - 새 줄은 M02 갈라 내기(`POST /api/m02/structures/{열}/material-combo`)가 만듦 — 같은 자재 집합이 있으면 그 키.

resources/master_data/_화면_계약.md

@@ -198,19 +198,7 @@
 
 ### 자재 조합
 
-재료산출에서 쓸 **자재 목록 묶음**(파일 `자재조합.json` · 키 `UM` · `_틀.md` 11장). 담은 자재 `{코드, 이름, 규격, 단위}` 만 지님 — 수량 · 단가 없음. 요소 그룹이 아님(`/groups` · `/rows` 에 안 끼고 제 길로만).
-
-| 길                    | 받음                            | 줌                                          |
-| --------------------- | ------------------------------- | ------------------------------------------- |
-| `GET /matsets`        | `q?` `owner?`                   | `{matsets: […]}` — 줄마다 `count` (자재 수) |
-| `GET /matset`         | `key`                           | `{file, version, matset}`                   |
-| `POST /matset/new`    | `{matset, owner?}`              | `{file, version, key, matset}`              |
-| `POST /matset/edit`   | `{key, version, matset, owner?}` | `{file, version, matset}`                   |
-| `POST /matset/delete` | `{key, version}`                | `{file, version}`                           |
-
-- 답 — 200 · 400(이름 없음 · 모르는 소유 · 없는/자기 본뜬키) · 404 · 409(낡은 판본 · 지우기 막음) · 422(없는 자재 코드 · 같은 자재 두 번 · 자재 줄 모양).
-- 지우기는 구조물집계표 · `구조물집계표조합` 의 「자재조합」 칸으로 쓰는 열이 있으면 409 `{detail: {errors: […], users: [구조물 이름…]}}` — 지우지 않음.
-- M02 화면이 새로 만드는 조합도 같은 파일 · 같은 길이라 M01 목록에 같이 보임.
+M01 에 없음 — 마스터 템플릿 표(`resources/master_template/자재조합.json` · 키 `UM` · `_틀.md` 11장) · 길과 화면은 M02(`/api/m02/material-combos…` · 좌측 「자재 조합」 컨테이너).
 
 ## 10. 재료 · 기계 고르기
 

resources/master_data/scripts/check_master.py

@@ -259,8 +259,6 @@ def check_combo_form(name: str, data: dict) -> list[str]:
 def check_form(name: str, data: dict) -> list[str]:
     if name == mcb.FILE:
         return check_combo_form(name, data)
-    if name == mmc.FILE:
-        return mmc.check_form(name, data)
     if name in SPECIAL_FILES:
         return []
     m = _FILE.match(name)
@@ -685,6 +683,7 @@ def main(argv: list[str]) -> int:
     report = {}
     if mode in ("틀", "전부"):
         report["틀"] = [x for name, data in files.items() for x in check_form(name, data)]
+        report["틀"] += mmc.check_file()  # 자재 조합은 마스터 템플릿 표
     if mode in ("본문", "전부"):
         report["본문"] = check_body(files)
     if mode in ("로직", "전부"):

resources/master_data/scripts/master_keys.py

@@ -32,13 +32,12 @@ TABLES = {
     ("로직", "건설품셈"): "GC",
     ("로직", "자체"): "GX",
     ("일위대가조합", None): "UA",
-    ("자재조합", None): "UM",
 }
 GROUP_OF = {tid: group for (group, _), tid in TABLES.items()}
 IDS = tuple(GROUP_OF)
 # 줄에 원문번호를 두지 않는 테이블 — 자재품목은 번호가 남의 품번이라 이름 몫을 못 하고,
 # 조합은 원문이 없어 번호 자체가 없음(대조는 대장에만)
-NO_NUMBER = ("MT", "UA", "UM")
+NO_NUMBER = ("MT", "UA")
 
 
 def table_id(group: str, book: str | None) -> str:
@@ -187,7 +186,6 @@ ROW_ORDER = {
         "소유",
         "비고",
     ),
-    "자재조합": ("키", "이름", "담은자재", "본뜬키", "소유", "비고"),
 }
 OLD_CHAPTER = re.compile(r"^(소요량|계수|로직)_(산림품셈|건설품셈)_(\D*)(\d+)장\.json$")
 CHAPTER = re.compile(r"^(소요량|계수|로직)_(산림품셈|건설품셈|자체)_(\d\d)장_.+\.json$")

resources/master_data/scripts/master_material_combo.py

@@ -1,12 +1,16 @@
 # -*- coding: utf-8 -*-
 """자재 조합 — 구조물 열 재료산출이 쓰는 자재 목록 묶음(키 UM · `_틀.md` 11장).
 
-담은 자재 목록만 지님(수량 · 계산은 재료산출 몫). 일위대가 조합(`master_combo`)과 같은 결 —
-갈라 내기(M02) 때 새 줄 · 본뜬키 = 원래 키.
+자리는 마스터 템플릿 `resources/master_template/자재조합.json`(구조물집계표조합.json 과 같은 결) ·
+키는 표 안 「다음」 번호(`_키대장` 밖). 담은 자재 목록만 지님(수량 · 계산은 재료산출 몫) ·
+갈라 내기(M02) 때 새 줄 · 본뜬키 = 원래 키. 저장 · 화면은 M02(`M02_MasterTemplete_Matset.py`).
 """
 
 from __future__ import annotations
 
+import json
+from pathlib import Path
+
 import master_combo as mcb
 import master_keys as mk
 
@@ -15,7 +19,8 @@ FILE = "자재조합.json"
 TID = "UM"
 OWNERS = mcb.OWNERS
 MAX_이름 = mcb.MAX_이름
-COLS = mk.ROW_ORDER[GROUP]  # 키 · 이름 · 담은자재 · 본뜬키 · 소유 · 비고
+PATH = Path(__file__).resolve().parents[2] / "master_template" / FILE
+COLS = ("키", "이름", "담은자재", "본뜬키", "소유", "비고")
 ITEM_COLS = ("코드", "이름", "규격", "단위")
 
 
@@ -30,12 +35,18 @@ def check_form(name: str, data: dict) -> list[str]:
     rows = data.get("줄")
     if not isinstance(rows, list):
         return out + [f"{name} · 머리 「줄」 목록 없음"]
+    after = data.get("다음")
+    if not isinstance(after, int) or after < 1:
+        out.append(f"{name} · 머리 「다음」 이 1 이상 정수 아님")
+        after = None
     seen_names: dict[str, str] = {}
     for row in rows:
         key = str(row.get("키"))
         where = f"{name} · {key} {row.get('이름') or ''}".strip()
         if not mk.KEY.fullmatch(key) or key[:2] != TID:
             out.append(f"{where} · 키 모양이 「{TID}」 + 6자리 아님")
+        elif after and int(key[2:]) >= after:
+            out.append(f"{where} · 키 번호가 머리 「다음」({after}) 보다 작지 않음")
         if tuple(row) != COLS:
             out.append(f"{where} · 열이 한 벌이 아님 — 「{' · '.join(COLS)}」")
         plain = row.get("이름").strip() if isinstance(row.get("이름"), str) else ""
@@ -64,3 +75,10 @@ def check_form(name: str, data: dict) -> list[str]:
                 out.append(f"{where} 줄{at} · 같은 자재를 두 번 담음 「{code}」")
             codes.add(code)
     return out
+
+
+def check_file(path: Path = PATH) -> list[str]:
+    """마스터 템플릿 자재 조합 표 — 없으면 한 줄."""
+    if not path.is_file():
+        return [f"{path.name} · 마스터 템플릿에 없음"]
+    return check_form(path.name, json.loads(path.read_text(encoding="utf-8")))

resources/master_template/자재조합.json

@@ -1,6 +1,7 @@
 {
   "그룹": "자재조합",
   "판": "2026",
-  "비고": ["자재 조합 = 구조물 열 재료산출이 쓰는 자재 목록 묶음 · 수량·계산은 두지 않음(재료산출 몫)"],
+  "비고": ["자재 조합 = 구조물 열 재료산출이 쓰는 자재 목록 묶음 · 수량·계산은 두지 않음(재료산출 몫) · 키 UM 은 「다음」 번호로 매김 · 지운 키는 다시 안 씀"],
+  "다음": 1,
   "줄": []
 }

resources/tester/test_m01_matset.py

@@ -1,107 +0,0 @@
-"""M01 자재 조합(`/api/m01/matset…` · 파일 `자재조합.json` · 키 UM) — 담은 자재 목록만 지님.
-
-못박는 것
-  - 새로 만들면 키를 서버가 `UM` 다음 번호로 줌 · 열 한 벌 · 담은 자재는 네 칸.
-  - 없는 자재 코드 · 같은 자재 두 번 · 이름 없음 · 없는 본뜬키는 막음.
-  - 고치기는 낡은 판본이면 409 · 지우기는 구조물 열이 「자재조합」 칸으로 쓰면 409 + 구조물 이름들.
-  - 정본은 읽기만 함(사본 폴더 · 사본 집계표).
-"""
-
-from __future__ import annotations
-
-import json
-import shutil
-from pathlib import Path
-
-import pytest
-from fastapi import FastAPI
-from fastapi.testclient import TestClient
-
-from M01_MasterData import M01_MasterData_Router as router_module
-from M01_MasterData import M01_MasterData_Store as store
-from M01_MasterData import M01_MasterData_Store_Combo as combo_store
-
-ROOT = Path(__file__).resolve().parents[2]
-
-
-@pytest.fixture
-def client(tmp_path: Path, monkeypatch) -> TestClient:
-    for path in store.FOLDER.glob("*.json"):
-        if not path.name.startswith("_") or path.name == store.mk.BOOK.name:
-            shutil.copy(path, tmp_path / path.name)
-    monkeypatch.setattr(store, "FOLDER", tmp_path)
-    sheet = tmp_path / "집계표.json"
-    sheet.write_text(json.dumps({"열": []}), encoding="utf-8")
-    monkeypatch.setattr(combo_store, "USERS", (sheet,))
-    app = FastAPI()
-    app.include_router(router_module.router)
-    return TestClient(app)
-
-
-def _mat(client: TestClient) -> dict:
-    """자재품목에서 실제 줄 하나 — 자재 찾기 길 그대로."""
-    got = client.get("/api/m01/pick", params={"kind": "price", "q": "합판", "limit": 2}).json()
-    one = got["items"][0]
-    return {"코드": one["ref"], "이름": one["이름"], "규격": one["규격"], "단위": one["단위"]}
-
-
-def _new(client: TestClient, name: str, mats: list[dict], **more) -> dict:
-    body = {"matset": {"이름": name, "담은자재": mats, **more}}
-    return client.post("/api/m01/matset/new", json=body)
-
-
-def test_정본_자재조합_파일은_틀대로다() -> None:
-    data = json.loads((ROOT / "resources/master_data/자재조합.json").read_text(encoding="utf-8"))
-    assert data["그룹"] == "자재조합" and isinstance(data["줄"], list)
-    assert store.cm.mmc.check_form("자재조합.json", data) == []
-    assert '"UM"' in (ROOT / "resources/master_data/_키대장.json").read_text(encoding="utf-8")
-
-
-def test_새로_만들면_UM_키와_열_한_벌(client) -> None:
-    mat = _mat(client)
-    res = _new(client, "합판 자재", [{**mat, "덤": 1}])
-    assert res.status_code == 200, res.text
-    made = res.json()
-    assert made["key"].startswith("UM") and len(made["key"]) == 8
-    assert tuple(made["matset"]) == store.cm.mmc.COLS
-    assert made["matset"]["담은자재"] == [mat] and made["matset"]["본뜬키"] is None
-    rows = client.get("/api/m01/matsets").json()["matsets"]
-    assert [(r["키"], r["count"]) for r in rows] == [(made["key"], 1)]
-    got = client.get("/api/m01/matset", params={"key": made["key"]}).json()
-    assert got["matset"]["이름"] == "합판 자재"
-
-
-def test_없는_자재_두_번_담기_이름_본뜬키는_막는다(client) -> None:
-    mat = _mat(client)
-    assert _new(client, "없는 코드", [{**mat, "코드": "MT999999"}]).status_code == 422
-    assert _new(client, "두 번", [mat, mat]).status_code == 422
-    assert _new(client, " ", [mat]).status_code == 400
-    assert _new(client, "없는 원본", [mat], 본뜬키="UM999999").status_code == 400
-    ok = _new(client, "원본", [mat]).json()["key"]
-    assert _new(client, "본뜬 것", [mat], 본뜬키=ok).json()["matset"]["본뜬키"] == ok
-    assert _new(client, "원본", [mat]).status_code == 422  # 이름 겹침
-
-
-def test_고치기는_낡은_판본이면_409(client) -> None:
-    mat = _mat(client)
-    key = _new(client, "고칠 것", [mat]).json()["key"]
-    one = client.get("/api/m01/matset", params={"key": key}).json()
-    body = {"key": key, "version": one["version"], "matset": {**one["matset"], "이름": "고침"}}
-    assert client.post("/api/m01/matset/edit", json=body).status_code == 200
-    assert client.post("/api/m01/matset/edit", json=body).status_code == 409  # 같은 옛 판본
-
-
-def test_쓰는_열이_있으면_못_지우고_없으면_지워진다(client) -> None:
-    mat = _mat(client)
-    key = _new(client, "쓰는 것", [mat]).json()["key"]
-    cols = [{"id": "c9", "머리": ["돌붙임", "찰붙임", "", ""], "자재조합": key}]
-    combo_store.USERS[0].write_text(json.dumps({"열": cols}, ensure_ascii=False), encoding="utf-8")
-    version = client.get("/api/m01/matset", params={"key": key}).json()["version"]
-    res = client.post("/api/m01/matset/delete", json={"key": key, "version": version})
-    assert res.status_code == 409 and res.json()["detail"]["users"] == ["돌붙임 찰붙임"]
-    combo_store.USERS[0].write_text(json.dumps({"열": []}), encoding="utf-8")
-    assert (
-        client.post("/api/m01/matset/delete", json={"key": key, "version": version}).status_code
-        == 200
-    )
-    assert client.get("/api/m01/matset", params={"key": key}).status_code == 404

resources/tester/test_m02_combo_branch.py

@@ -1,6 +1,7 @@
 """조합 갈라 내기 · 분류 더하기 복사 (PLAN 15장).
 
-M02 견본 표(`write_sample_table`) + M01 마스터 사본(조합 줄은 비워 시작)으로만 봄.
+M02 견본 표(`write_sample_table`) + M01 마스터 사본(조합 줄은 비워 시작)으로만 봄 · 자재 조합 표는
+마스터 템플릿 사본(없이 시작).
   · 일위대가(UA) — 새로 만듦(본뜬키 = 원래 키) · 이 열만 새 키 · 다른 열은 옛 키 · 원래 조합 그대로 ·
     SS 장부 맞춤 · 담은 로직 집합(차례 · 메모 무시)이 같으면 있는 키 · 또 고치면 또 새로 · 같은 이름 (2)
   · 자재 조합(UM) — 같은 규칙 · 처음 만드는 열(본뜬키 없음) · 읽기
@@ -17,7 +18,6 @@ from fastapi.testclient import TestClient
 
 from M01_MasterData import M01_MasterData_Store as m01
 from M01_MasterData import M01_MasterData_Store_Combo as combo_store
-from M02_MasterTemplete import M02_MasterTemplete_Branch as branch
 from M02_MasterTemplete import M02_MasterTemplete_Store as store
 from M02_MasterTemplete.M02_MasterTemplete_Router import router
 from resources.tester.test_m02_structure import write_sample_table
@@ -25,8 +25,8 @@ from resources.tester.test_m02_structure import write_sample_table
 REAL = m01.FOLDER
 A, B, C = "GF000219", "GF000220", "GF000211"  # 돌쌓기 메쌓기(인력 · 장비) · 채집(인력)
 M1, M2 = (
-    {"코드": "MT000001", "이름": "시멘트", "규격": "40kg", "단위": "포"},
-    {"코드": "MT000002", "이름": "모래", "규격": None, "단위": "㎥"},
+    {"코드": "MT000008", "이름": "시멘트", "규격": "40kg", "단위": "포"},
+    {"코드": "MT000009", "이름": "모래", "규격": None, "단위": "㎥"},
 )
 TABLE = "/api/m02/templates/table/구조물집계표"
 
@@ -38,11 +38,10 @@ def client(tmp_path, monkeypatch):
     for path in REAL.glob("*.json"):
         if not path.name.startswith("_") or path.name == m01.mk.BOOK.name:
             shutil.copy(path, master / path.name)
-    for name in (combo_store.FILE, branch.MATERIAL_FILE):
-        own = master / name
-        data = json.loads(own.read_text(encoding="utf-8"))
-        data["줄"] = []
-        own.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+    own = master / combo_store.FILE
+    data = json.loads(own.read_text(encoding="utf-8"))
+    data["줄"] = []
+    own.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
     monkeypatch.setattr(m01, "FOLDER", master)
     template = tmp_path / "template"
     template.mkdir()
@@ -168,7 +167,7 @@ def test_자재_조합_처음_만듦_같은_내용이면_있는_키_고치면_
     )
     assert _ss(client, "자재조합")["c1"] == fork["키"]
     assert client.get("/api/m02/material-combos/UM999999").status_code == 404
-    _material(client, "rv", "", [{"코드": "없는모양"}], want=422)  # M01 저장 검사
+    _material(client, "rv", "", [{"코드": "없는모양"}], want=422)  # 자재 조합 저장 검사
 
 
 def test_분류_더하기로_복사한_열은_원본_키_세_파일_내용을_받음(client):

resources/tester/test_m02_matset.py

@@ -0,0 +1,125 @@
+"""M02 자재 조합(`/api/m02/material-combos…` · 마스터 템플릿 `자재조합.json` · 키 UM).
+
+못박는 것
+  - 정본 표는 마스터 템플릿 자리 · 틀대로(머리 「다음」) · 키 대장에 UM 없음 · M01 길 없음.
+  - 새로 만들면 키 = 표 「다음」 번호 · 열 한 벌 · 담은 자재는 네 칸 · 지운 키는 다시 안 씀.
+  - 없는 자재 코드 · 같은 자재 두 번 · 이름 없음 · 이름 겹침 · 없는 본뜬키는 막음.
+  - 고치기 · 지우기는 낡은 판이면 409 · 본뜬키는 고쳐도 그대로 · 쓰는 열이 있으면 못 지움.
+  - 정본은 읽기만 함(사본 폴더 · 견본 집계표).
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import pytest
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from M01_MasterData import M01_MasterData_Router as m01_router
+from M01_MasterData import M01_MasterData_Store as m01
+from M02_MasterTemplete import M02_MasterTemplete_Matset as matset
+from M02_MasterTemplete import M02_MasterTemplete_Store as store
+from M02_MasterTemplete.M02_MasterTemplete_Router import router
+from resources.tester.test_m02_structure import write_sample_table
+
+ROOT = Path(__file__).resolve().parents[2]
+M1, M2 = (
+    {"코드": "MT000008", "이름": "시멘트", "규격": "40kg", "단위": "포"},
+    {"코드": "MT000009", "이름": "모래", "규격": "", "단위": "㎥"},
+)
+URL = "/api/m02/material-combos"
+TABLE = "/api/m02/templates/table/구조물집계표"
+
+
+@pytest.fixture
+def client(tmp_path: Path, monkeypatch) -> TestClient:
+    write_sample_table(tmp_path)
+    monkeypatch.setattr(store, "FOLDER", tmp_path)
+    app = FastAPI()
+    app.include_router(router)
+    return TestClient(app)
+
+
+def _new(client: TestClient, name: str, mats: list[dict], 판: str | None = None, **more):
+    if 판 is None:
+        판 = client.get(URL).json()["판"]
+    return client.post(URL, json={"판": 판, "줄": {"이름": name, "담은자재": mats, **more}})
+
+
+def test_정본_표는_마스터_템플릿_자리_틀대로_UM_은_대장_밖() -> None:
+    path = ROOT / "resources/master_template/자재조합.json"
+    data = json.loads(path.read_text(encoding="utf-8"))
+    assert data["그룹"] == "자재조합" and isinstance(data["다음"], int)
+    assert matset.mmc.check_file(path) == []
+    assert not (ROOT / "resources/master_data/자재조합.json").exists()
+    book = (ROOT / "resources/master_data/_키대장.json").read_text(encoding="utf-8")
+    assert '"UM"' not in book.splitlines()[1]  # 대장 머리 「다음」
+    assert not any("matset" in getattr(r, "path", "") for r in m01_router.router.routes)
+
+
+def test_새로_만들면_다음_번호_열_한_벌_지운_키는_다시_안_씀(client) -> None:
+    res = _new(client, "합판 자재", [{**M1, "덤": 1}])
+    assert res.status_code == 200, res.text
+    made = res.json()
+    assert made["키"] == "UM000001" and tuple(made["줄"]) == matset.mmc.COLS
+    assert made["줄"]["담은자재"] == [M1] and made["줄"]["본뜬키"] is None
+    listed = client.get(URL).json()
+    assert listed["판"] == made["판"] and [r["키"] for r in listed["줄"]] == ["UM000001"]
+    assert client.get(f"{URL}/UM000001").json()["이름"] == "합판 자재"
+    assert client.delete(f"{URL}/UM000001", params={"판": made["판"]}).status_code == 200
+    again = _new(client, "다음 것", [M2]).json()
+    assert again["키"] == "UM000002"  # 지운 번호는 다시 안 씀
+    assert json.loads((store.FOLDER / matset.FILE).read_text(encoding="utf-8"))["다음"] == 3
+
+
+def test_없는_자재_두_번_이름_본뜬키는_막는다(client) -> None:
+    assert _new(client, "없는 코드", [{**M1, "코드": "MT999999"}]).status_code == 422
+    assert _new(client, "두 번", [M1, M1]).status_code == 422
+    assert _new(client, " ", [M1]).status_code == 400
+    assert _new(client, "빈 것", []).status_code == 422
+    assert _new(client, "없는 원본", [M1], 본뜬키="UM999999").status_code == 400
+    ok = _new(client, "원본", [M1]).json()["키"]
+    copy = _new(client, "본뜬 것", [M1, M2], 본뜬키=ok).json()
+    assert copy["줄"]["본뜬키"] == ok and copy["키"] != ok
+    assert _new(client, "원본", [M2]).status_code == 422  # 이름 겹침
+    assert _new(client, "낡은 판", [M2], 판="0000").status_code == 409
+
+
+def test_고치기는_낡은_판이면_409_본뜬키는_그대로(client) -> None:
+    src = _new(client, "원본", [M1]).json()["키"]
+    made = _new(client, "고칠 것", [M1], 본뜬키=src).json()
+    row = {**made["줄"], "이름": "고침", "담은자재": [M1, M2], "본뜬키": None}
+    res = client.put(f"{URL}/{made['키']}", json={"판": made["판"], "줄": row})
+    assert res.status_code == 200, res.text
+    assert res.json()["줄"]["이름"] == "고침" and res.json()["줄"]["본뜬키"] == src
+    assert client.put(f"{URL}/{made['키']}", json={"판": made["판"], "줄": row}).status_code == 409
+    assert client.put(f"{URL}/UM999999", json={"판": "", "줄": row}).status_code == 404
+
+
+def test_쓰는_열이_있으면_못_지우고_없으면_지워진다(client) -> None:
+    made = _new(client, "쓰는 것", [M1]).json()
+    table = client.get(TABLE).json()
+    for col in table["문서"]["열"]:
+        if col["id"] == "rv":
+            col["자재조합"] = made["키"]
+    assert client.put(TABLE, json={"판": table["판"], "문서": table["문서"]}).status_code == 200
+    res = client.delete(f"{URL}/{made['키']}", params={"판": made["판"]})
+    assert client.get(URL).json()["쓰는곳"] == {made["키"]: ["돌기슭막이 (형태마다) H=(높이마다)"]}
+    assert res.status_code == 409 and res.json()["detail"]["users"] == [
+        "돌기슭막이 (형태마다) H=(높이마다)"
+    ]
+    rows = client.get("/api/m02/structure-combos").json()["줄"]
+    assert next(r for r in rows if r["열"] == "rv")["자재조합"] == made["키"]  # SS 장부 칸
+    table = client.get(TABLE).json()
+    for col in table["문서"]["열"]:
+        col.pop("자재조합", None)
+    assert client.put(TABLE, json={"판": table["판"], "문서": table["문서"]}).status_code == 200
+    assert client.delete(f"{URL}/{made['키']}", params={"판": "낡음"}).status_code == 409
+    assert client.delete(f"{URL}/{made['키']}", params={"판": made["판"]}).status_code == 200
+    assert client.get(f"{URL}/{made['키']}").status_code == 404
+
+
+def test_M01_마스터는_UM_을_모른다() -> None:
+    assert "UM" not in m01.cm.mk.IDS and "자재조합" not in m01.cm.mk.ROW_ORDER