feat(M02): 구조물집계표조합 표 — 구조물 열마다 한 줄 · 키 SS · 집계표 [저장] 때 서버가 맞춤

- resources/master_template/구조물집계표조합.json (그룹 · 판 · 비고 · 다음 · 줄) · 지금 열 51개로 처음 만듦(SS000001~SS000051)
- 줄 칸: 키 · 열 · 종류 · 분류1~3 · 단위 · 일위대가 · 도번 · 면적번 · 재료번 · 바인딩 · 펼침 · 꼴=수 열만
- 새 열 = 새 SS 키 · 지운 열 = 줄 지움(키 다시 안 씀) · 고친 열 = 칸 갱신 · 새 프로젝트 복사에도 실림
- GET /api/m02/structure-combos · Api_Fetch fetchStructureCombos()
- 시험: 견본 표로 키 유지 · 새 열 · 지운 열 · 글 열 제외 · 키대장 머리글과 안 겹침 · 프로젝트 복사

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

M02_MasterTemplete/M02_MasterTemplete_Api_Fetch.ts

@@ -128,6 +128,31 @@ export interface StructureNumbers {
 export const fetchStructureNumbers = (): Promise<Record<string, StructureNumbers>> =>
   call("/structures/numbers");
 
+/** 구조물집계표조합 한 줄 — 구조물 열 하나(키 `SS` + 6자리 · 한 번 준 키는 안 바뀜) */
+export interface StructureCombo extends StructureNumbers {
+  키: string;
+  열: string;
+  종류: string | null;
+  분류1: string | null;
+  분류2: string | null;
+  분류3: string | null;
+  단위: string | null;
+  일위대가: string | null;
+  바인딩: unknown;
+  펼침: unknown;
+}
+
+export interface StructureCombos {
+  그룹: string;
+  판: number;
+  비고: string;
+  다음: number;
+  줄: StructureCombo[];
+}
+
+/** 조합 표 — 서버가 집계표 [저장] 때 맞춤(읽기만) */
+export const fetchStructureCombos = (): Promise<StructureCombos> => call("/structure-combos");
+
 /** 다른 열(`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_Router.py

@@ -37,6 +37,12 @@ def get_structure_numbers() -> dict:
     return _call(store.structure_numbers)
 
 
+@router.get("/structure-combos")
+def get_structure_combos() -> dict:
+    """구조물집계표조합 — 구조물 열마다 줄 하나(키 SS · 제목행 · 번호 · 바인딩) · 읽기만."""
+    return _call(store.read_combos)
+
+
 @router.post("/structures/{column}")
 def post_structure(column: str) -> dict:
     """구조물 도면 새로 — 열 id 하나 · 도번 자동 · 빈 면적산출 · 재료산출도 · 이미 있으면 409."""

M02_MasterTemplete/M02_MasterTemplete_Store.py

@@ -120,6 +120,7 @@ def write(kind: str, name: str, version: str, doc: Any) -> dict[str, Any]:
     if kind == "table" and name == STRUCTURE_TABLE:
         backfill_missing_structures()  # 지우기 앞 — 같은 저장의 새 열이 지운 번호를 안 받게
         prune_removed_structures()
+        sync_combos()  # 번호가 다 선 뒤 — 조합 표 도번 · 면적번 · 재료번 칸
     return info
 
 
@@ -369,3 +370,59 @@ def backfill_missing_structures() -> list[str]:
     for cid in _column_ids():
         made += [f"{kind}/{cid}" for kind in _KEY if _ensure(kind, cid)]
     return made
+
+
+# ── 구조물집계표조합 ─────────────────────
+# 구조물 열마다 줄 하나(제어용 장부 · 관리자는 집계표 화면으로 고침 · 서버가 집계표로 맞춤) ·
+# 키 = SS + 6자리 · 한 번 준 키는 그 열에 남음 · 지운 열의 키는 다시 안 씀(`다음` 이 기억)
+COMBO_FILE = layers.COMBO_FILE
+_COMBO_HEAD = "SS"
+_COMBO_NOTE = (
+    "구조물집계표 구조물 열(꼴=수)마다 한 줄 · 서버가 집계표 [저장] 때 맞춤(손으로 고치지 않음) · "
+    "키 SS 는 한 번 주면 안 바뀌고 지운 열의 키는 다시 안 씀"
+)
+
+
+def _combo_row(key: str, col: dict[str, Any], numbers: dict[str, str]) -> dict[str, Any]:
+    kind, level1, level2, level3 = _heads(col)
+    return {
+        "키": key,
+        "열": col["id"],
+        "종류": kind,
+        "분류1": level1,
+        "분류2": level2,
+        "분류3": level3,
+        "단위": col.get("단위"),
+        "일위대가": col.get("일위대가"),
+        **{field: numbers.get(field, "") for _, field, _, _ in PARTS},
+        "바인딩": col.get("바인딩"),
+        "펼침": col.get("펼침"),
+    }
+
+
+def sync_combos() -> dict[str, Any]:
+    """조합 표를 집계표에 맞춤 — 새 열 = 새 SS 키 · 지운 열 = 줄 지움 · 고친 열 = 칸 갱신 ·
+    줄 차례 = 집계표 열 차례. 바뀐 것이 없으면 파일을 안 씀."""
+    path = FOLDER / COMBO_FILE
+    with _LOCK:
+        old = json.loads(path.read_bytes()) if path.is_file() else {}
+        keys = {row["열"]: row["키"] for row in old.get("줄", [])}
+        taken = [int(k[len(_COMBO_HEAD) :]) for k in keys.values()]
+        after = max(old.get("다음", 1), max(taken, default=0) + 1)
+        numbers = structure_numbers()
+        rows = []
+        for col in _structure_columns():
+            if col["id"] not in keys:
+                keys[col["id"]] = f"{_COMBO_HEAD}{after:06d}"
+                after += 1
+            rows.append(_combo_row(keys[col["id"]], col, numbers.get(col["id"], {})))
+        doc = {"그룹": "구조물집계표조합", "판": 1, "비고": _COMBO_NOTE, "다음": after, "줄": rows}
+        if doc != old:
+            atomic_write_json(path, doc)
+    return doc
+
+
+def read_combos() -> dict[str, Any]:
+    """조합 표 — 파일이 아직 없으면 지금 열 전부로 처음 한 번 만듦."""
+    path = FOLDER / COMBO_FILE
+    return json.loads(path.read_bytes()) if path.is_file() else sync_combos()

M02_MasterTemplete/M02_Template_Layers.py

@@ -31,6 +31,7 @@ KINDS = ("table", "drawing", "structure", "area", "material")
 TEMPLATES_DIRNAME = "templates"
 INITIAL_DIRNAME = "_initial"
 MANIFEST_NAME = "manifest.json"
+COMBO_FILE = "구조물집계표조합.json"  # 층 뿌리의 한 파일(종류 폴더 밖)
 
 #: 시스템 층 뿌리 — 시험이 임시 폴더로 바꿈.
 SYSTEM_ROOT = config_system.PROJECT_ROOT / "resources" / "master_template"
@@ -317,6 +318,7 @@ def seed_project(project_root: str | Path, *, only_missing: bool = False) -> dic
     프로젝트 만들 때 · 옛 프로젝트 넣기(`only_missing`) 둘 다 이 길.
 
     `_initial/` 은 늘 없는 것만 더함 — 이미 있으면 절대 덮지 않음.
+    구조물집계표조합(층 뿌리의 한 파일)도 같이 실림.
     """
     return {
         "작업본": copy_templates(
@@ -324,13 +326,27 @@ def seed_project(project_root: str | Path, *, only_missing: bool = False) -> dic
             project_dir(project_root),
             source_layer="system",
             only_missing=only_missing,
-        ),
+        )
+        + _copy_combo(project_dir(project_root), only_missing),
         "초기": copy_templates(
             system_dir(), initial_dir(project_root), source_layer="system", only_missing=True
-        ),
+        )
+        + _copy_combo(initial_dir(project_root), True),
     }
 
 
+def _copy_combo(target_dir: Path, only_missing: bool) -> list[str]:
+    source = system_dir() / COMBO_FILE
+    target = target_dir / COMBO_FILE
+    if not source.is_file() or (only_missing and target.exists()):
+        return []
+    target_dir.mkdir(parents=True, exist_ok=True)
+    temporary = target.with_name(f".{target.name}.tmp")
+    shutil.copyfile(source, temporary)
+    temporary.replace(target)
+    return [target.stem]
+
+
 def reset_project(
     project_root: str | Path, *, kind: str | None = None, name: str | None = None
 ) -> list[str]: