feat(M02): 48-2 구조물 옵션 정의 편집 화면 — 군 · 종류 · 옵션 · 선택지 · 배치 격자 · 그룹 형상 · 규칙 · 판 이력

- 옛 「옵션 보이기 · 그룹」 화면을 정의 편집 화면으로 넓힘(시스템 관리자 고쳐 씀 · 다른 역할 읽기만)
- 자료 손질 = M02_SO_Def_Model.ts(정의 틀 48-1 꼴) · 시험 test_m02_so_def_model.py

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

M02_MasterTemplete/StructOptions/M02_SO_Api.ts

@@ -1,56 +1,29 @@
 /* =============================================================================
  * M02_SO_Api.ts
- * 구조물 옵션 보이기 · 그룹 서버 호출 — 서버 = `M02_SO_Router.py`
- * (마스터 템플릿 `구조물옵션표시.json` · `구조물옵션그룹.json`)
+ * 구조물 정의 서버 호출 — 서버 = `M02_SO_Router.py`(마스터 템플릿 `구조물정의.json` 한 벌 · PLAN 48)
  * ========================================================================== */
 
 import { call } from "../M02_MasterTemplete_Api_Fetch";
+import type { StructDef } from "./M02_SO_Def_Model";
 
-export interface OptionKind {
-  type_id: string;
-  group: string;
-  name: string;
-  /** 거짓이면 B05 선택지에 안 나오는 종류 */
-  enabled: boolean;
-  options: { key: string; label: string; phase: "b05" | "detail"; required: boolean }[];
+/* --- 구조물 정의(PLAN 48 · 마스터 템플릿 `구조물정의.json` · 판 번호 · 이력) --- */
+
+/** 지난 판 한 줄 */
+export interface DefVersion {
+  판: number;
+  저장일: string;
 }
 
-/** 판 · 표시(숨긴 것만 `{종류: {옵션: false}}`) · 종류(옵션이 있는 것과 그 옵션) */
-export interface OptionsDoc {
-  판: string;
-  표시: Record<string, Record<string, false>>;
-  종류: OptionKind[];
-}
+/** 정의 한 벌 — 읽기 = 로그인 누구나 */
+export const fetchStructureDef = (): Promise<StructDef> => call("/structure-definition");
 
-export const fetchStructureOptions = (): Promise<OptionsDoc> =>
-  call("/layers/system/structure-options"); // 읽기 = 로그인 누구나 · 고쳐 씀은 시스템 관리자
+/** 통째로 고쳐 씀(시스템 관리자만) — 읽어 간 판이 지금 판과 다르면 StaleError · 돌려받는 것 = 판 +1 정의 */
+export const saveStructureDef = (판: number, 정의: StructDef): Promise<StructDef> =>
+  call("/structure-definition", { method: "PUT", body: JSON.stringify({ 판, 정의 }) });
 
-/** 고쳐 씀 — 숨긴 것만 보냄 · 낡은 판이면 StaleError · 돌려받는 것은 새 문서 */
-export const saveStructureOptions = (판: string, 표시: OptionsDoc["표시"]): Promise<OptionsDoc> =>
-  call("/structure-options", { method: "PUT", body: JSON.stringify({ 판, 표시 }) });
+/** 지난 판 목록(`구조물정의_이력/판_N.json`) */
+export const fetchStructureDefHistory = (): Promise<DefVersion[]> =>
+  call("/structure-definition/history");
 
-/* --- 옵션 그룹(PLAN 46-2 · 마스터 템플릿 `구조물옵션그룹.json` · 시스템 관리자만) --- */
-
-/** 그룹 하나 = 프로젝트 폼의 보조 컨테이너 하나(제목 = 이름) · 옵션 0 도 됨 */
-export interface OptionGroupDef {
-  id: string;
-  이름: string;
-  옵션: string[];
-}
-
-/** 판 · 그룹(`{종류: 그룹[]}`) · 종류(레지스트리 전부 — 옵션 없는 종류도) */
-export interface GroupsDoc {
-  판: string;
-  그룹: Record<string, OptionGroupDef[]>;
-  종류: OptionKind[];
-}
-
-export const fetchStructureOptionGroups = (): Promise<GroupsDoc> =>
-  call("/structure-option-groups");
-
-/** 고쳐 씀 — 낡은 판이면 StaleError · 돌려받는 것은 새 문서 */
-export const saveStructureOptionGroups = (
-  판: string,
-  그룹: GroupsDoc["그룹"],
-): Promise<GroupsDoc> =>
-  call("/structure-option-groups", { method: "PUT", body: JSON.stringify({ 판, 그룹 }) });
+export const fetchStructureDefAt = (판: number): Promise<StructDef> =>
+  call(`/structure-definition/history/${판}`);