Merge remote-tracking branch 'origin/sub_laptop_2' into sub_laptop_3

M02_MasterTemplete/M02_MasterTemplete_Structure.ts

@@ -1,7 +1,9 @@
 /* =============================================================================
  * M02_MasterTemplete_Structure.ts
- * 구조물집계표 아래 설계 컨테이너 — 고른 열의 구조물 도면 미리보기 · [도면 수정] · 상세 산출근거 표.
+ * 구조물집계표 아래 설계 컨테이너 — 고른 열의 구조물 도면 미리보기 · [도면 수정] · 상세 산출근거.
  * 카드 둘(도면 정보 · 상세 산출근거)은 좌측 패널과 같은 공용 ui-sidebar 틀.
+ * 상세 산출근거 = 스프레드시트(`A00_Common/spreadsheet/`) · 열마다 따로 파일(`basis/<열 id>.json`) ·
+ * 부품은 이 카드를 열 때만 `import()` 로 받음(다른 페이지 번들에 안 섞임) · [산출근거 저장] 때 서버가 다시 풂.
  *
  * 구조물 도면은 집계표 열마다 하나(`resources/master_template/structure/<열 id>.json`) ·
  * 서버가 열마다 미리 만들어 둠(도번 자동 · 새 열도 집계표 저장 때 서버가 같이 만듦 — `M02_MasterTemplete_Store.py`).
@@ -11,7 +13,7 @@
 
 import { createButton, el, showConfirmDialog, showToast } from "@ui/ui_template_elements";
 import { attachCollapsible } from "@ui/ui_template_collapsible";
-import { createSheet, type SheetDoc, type SheetHandle } from "@ui/sheet/ui_template_sheet";
+import type { SpreadsheetHandle, Workbook } from "../A00_Common/spreadsheet/spreadsheet";
 import {
   fetchStructureNumbers,
   readTemplate,
@@ -36,17 +38,20 @@ const TEXT = {
   basis: "상세 산출근거",
   noNumber: "도번 없음",
   noDrawing: "도면 없음",
-  noBasis: "표 없음 — 도면이 아직 없음",
+  noBasis: "산출근거 없음",
+  noSheet: "스프레드시트를 못 띄움 — {value}",
   saved: "산출근거를 저장했음",
   dirty: "저장 안 한 산출근거 고침이 있음 — 버리고 넘어갈까?",
   kept: "열을 바꾸지 않음 — 산출근거를 먼저 저장할 것",
-  stale: "그 사이 구조물 도면이 바뀜 — 열을 다시 고를 것",
+  stale: "그 사이 산출근거가 바뀜 — 열을 다시 고를 것",
   readFailed: "구조물 도면을 못 읽음 — {value}",
   saveFailed: "저장 못 함 — {value}",
 };
 
 const why = (error: unknown): string => (error instanceof Error ? error.message : "");
 const fill = (text: string, value: string): string => text.replace("{value}", value);
+/** 스프레드시트는 산출근거 카드를 열 때만 받음 */
+const loadSpreadsheet = () => import("../A00_Common/spreadsheet/spreadsheet");
 
 /** 집계표 열 — 머리 글만 씀 */
 export interface StructureColumn {
@@ -83,9 +88,10 @@ export function createStructurePanel(opts: StructurePanelOptions): StructurePane
   let column: string | null = null;
   let columnLabel = "";
   let doc: StructureDoc | null = null;
-  let version = "";
+  let basisDoc: Workbook | null = null;
+  let basisVersion = "";
   let preview: DrawingTemplateHandle | null = null;
-  let basis: SheetHandle | null = null;
+  let basis: SpreadsheetHandle | null = null;
   let basisDirty = false;
   let busy = false;
   let seq = 0;
@@ -146,19 +152,34 @@ export function createStructurePanel(opts: StructurePanelOptions): StructurePane
     apply();
   };
 
-  /** 미리보기 · 산출근거 표 — 문서가 없으면 없음 글(서버가 열마다 미리 만들어 둬 보통은 없음) */
-  const paintBody = (): void => {
+  /** 산출근거 스프레드시트 — 부품을 늦게 받음 · 그 사이 열이 바뀌면 버림 */
+  const paintBasis = async (mine: number): Promise<void> => {
+    if (!basisDoc) return void basisHost.replaceChildren(note(TEXT.noBasis));
+    try {
+      const { createSpreadsheet } = await loadSpreadsheet();
+      if (mine !== seq || !basisDoc) return;
+      basis = createSpreadsheet(basisHost, basisDoc, {
+        readOnly: !opts.isAdmin,
+        onChange: () => (basisDirty = true),
+      });
+    } catch (error) {
+      if (mine === seq) basisHost.replaceChildren(note(fill(TEXT.noSheet, why(error))));
+    }
+  };
+
+  /** 미리보기 · 산출근거 — 문서가 없으면 없음 글(서버가 열마다 미리 만들어 둬 보통은 없음) */
+  const paintBody = (mine: number): void => {
     drop();
     number.textContent = doc?.도번 || numbers[column ?? ""] || TEXT.noNumber;
     edit.hidden = !opts.isAdmin;
-    saveBasis.hidden = !opts.isAdmin || !doc;
+    saveBasis.hidden = !opts.isAdmin || !basisDoc;
+    basisHost.replaceChildren();
+    void paintBasis(mine);
     if (!doc) {
       previewHost.replaceChildren(note(TEXT.noDrawing));
-      basisHost.replaceChildren(note(TEXT.noBasis));
       return;
     }
     previewHost.replaceChildren();
-    basisHost.replaceChildren();
     // 미리보기 — 도면 양식과 같은 부품을 읽기만으로. 자동백업 칸은 편집 화면과 갈라 둠.
     preview = mountDrawingTemplate(previewHost, doc.도면 as unknown as DrawingTemplateDoc, {
       readOnly: true,
@@ -167,10 +188,6 @@ export function createStructurePanel(opts: StructurePanelOptions): StructurePane
     });
     const frame = previewHost.querySelector("iframe");
     if (frame) hideToolbar(frame);
-    basis = createSheet(basisHost, doc.산출근거 as unknown as SheetDoc, {
-      mode: "master",
-      onChange: () => (basisDirty = true),
-    });
   };
 
   async function load(col: StructureColumn | null): Promise<void> {
@@ -188,20 +205,23 @@ export function createStructurePanel(opts: StructurePanelOptions): StructurePane
     columnName.textContent = columnLabel;
     number.textContent = numbers[col.id] ?? TEXT.noNumber;
     doc = null;
-    version = "";
+    basisDoc = null;
+    basisVersion = "";
     previewHost.replaceChildren();
     basisHost.replaceChildren();
-    try {
-      const got = await readTemplate("system", "structure", col.id, null);
-      if (mine !== seq) return;
-      doc = got.문서 as StructureDoc;
-      version = got.판 ?? "";
-    } catch (error) {
-      if (mine !== seq) return;
-      // 도번 목록에 있는 열인데 못 읽으면 알림 — 없는 열은 그냥 「도면 없음」
-      if (numbers[col.id]) showToast(fill(TEXT.readFailed, why(error)), "error");
+    const [drawing, sheet] = await Promise.allSettled([
+      readTemplate("system", "structure", col.id, null),
+      readTemplate("system", "basis", col.id, null),
+    ]);
+    if (mine !== seq) return;
+    if (drawing.status === "fulfilled") doc = drawing.value.문서 as StructureDoc;
+    // 도번 목록에 있는 열인데 못 읽으면 알림 — 없는 열은 그냥 「도면 없음」
+    else if (numbers[col.id]) showToast(fill(TEXT.readFailed, why(drawing.reason)), "error");
+    if (sheet.status === "fulfilled") {
+      basisDoc = sheet.value.문서 as Workbook;
+      basisVersion = sheet.value.판 ?? "";
     }
-    paintBody();
+    paintBody(mine);
   }
 
   const show = (colId: string | null, columns: StructureColumn[]): void => {
@@ -217,17 +237,15 @@ export function createStructurePanel(opts: StructurePanelOptions): StructurePane
 
   saveBasis.addEventListener("click", async () => {
     const at = column;
-    if (!at || !doc || !basis || busy) return;
+    if (!at || !basis || busy) return;
     busy = true;
     saveBasis.disabled = true;
     try {
-      const next: StructureDoc = {
-        ...doc,
-        산출근거: basis.getDoc() as unknown as StructureDoc["산출근거"],
-      };
-      const info = await saveTemplate("system", "structure", at, null, version, next);
-      version = info.판;
-      doc = next;
+      // 계산값은 서버가 같은 엔진으로 다시 풀어 적음(보낸 값은 버림)
+      const next = basis.getDoc();
+      const info = await saveTemplate("system", "basis", at, null, basisVersion, next);
+      basisVersion = info.판;
+      basisDoc = next;
       basisDirty = false;
       showToast(TEXT.saved, "success");
     } catch (error) {