feat(z01): 좌측 패널을 B03~B09 도킹 사이드바 양식으로(상자 둘 — 기초단가 · 마스터 트리) · 기초단가 다섯(노임·기계·자재·유가·요율) 표 + 칸 고치기(editable 만 · 못 고치는 칸은 까닭·산출근거) · 덮개 판정은 서버 state 만(원본 바뀜·주인 없음은 줄째 또렷이 · 단추 글자에 값) · 요율 알림 · 고친 것 모아 보기(서버 정렬) · 공용 오버레이에 진행단계·프로젝트 이름 끄기 선택(브레인)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016VBGFXB9AbJBwXP19z75Qq

Z01_MasterData/Z01_MasterData_Api_Fetch.ts

@@ -6,7 +6,7 @@
  * ========================================================================== */
 
 import { API_BASE_URL } from "@config/config_frontend";
-import type { MasterColumn } from "./Z01_MasterData_UI_Cells";
+import type { MasterColumn, OverrideState, TableMeta } from "./Z01_MasterData_UI_Cells";
 
 export interface MasterTable {
   id: string;
@@ -32,36 +32,83 @@ export interface MasterGroup {
   files: MasterFile[];
 }
 
-export interface MasterRows {
+/** 기초단가 표만 editable·locked·formula 를 실음 — 트리 표는 읽기 전용이라 안 옴. */
+export interface MasterRows extends TableMeta {
   columns: MasterColumn[];
   rows: Record<string, unknown>[];
   total: number;
 }
 
-async function request<T>(path: string): Promise<T> {
-  const response = await fetch(`${API_BASE_URL}${path}`, { credentials: "include" });
+export interface RowsQuery {
+  page: number;
+  size: number;
+  q: string;
+}
+
+/** 기초단가 다섯 — 고친 값은 원본이 아니라 덮개 파일에 쌓임(품셈이 갱신돼도 안 날아감). */
+export const BASE_PRICE_KINDS = ["labor", "machine", "material", "oil", "rate"] as const;
+export type BasePriceKind = (typeof BASE_PRICE_KINDS)[number];
+
+async function request<T>(path: string, init: RequestInit = {}): Promise<T> {
+  const response = await fetch(`${API_BASE_URL}${path}`, {
+    credentials: "include",
+    headers: { "Content-Type": "application/json" },
+    ...init,
+  });
   const data = (await response.json()) as { detail?: string } & T;
   if (!response.ok) throw new Error(data.detail ?? "Request failed");
   return data;
 }
 
+const pageParams = (query: RowsQuery): Record<string, string> => ({
+  page: String(query.page),
+  size: String(query.size),
+  q: query.q,
+});
+
+export function fetchBasePrices(kind: BasePriceKind, query: RowsQuery): Promise<MasterRows> {
+  const params = new URLSearchParams(pageParams(query));
+  return request<MasterRows>(`/master-data/base-prices/${kind}?${params}`);
+}
+
+export interface OverrideItem {
+  kind: BasePriceKind;
+  row_id: string;
+  row_label: string;
+  column: string;
+  column_label: string;
+  original: unknown;
+  current?: unknown;
+  value: unknown;
+  state: OverrideState;
+}
+
+/** 고친 것 모아 보기 — 서버가 source_changed → orphan → edited 차례로 정렬해 줌. */
+export async function fetchOverrides(): Promise<OverrideItem[]> {
+  return (await request<{ items: OverrideItem[] }>("/master-data/overrides")).items;
+}
+
+/** 칸 고치기 — 값 null = 덮개에서 그 칸을 빼 원래 값으로 되돌림. 응답은 고친 뒤 그 줄. */
+export function saveBasePrice(
+  kind: BasePriceKind,
+  rowId: string,
+  values: Record<string, unknown>,
+): Promise<Record<string, unknown>> {
+  return request(`/master-data/base-prices/${kind}/${encodeURIComponent(rowId)}`, {
+    method: "PUT",
+    body: JSON.stringify({ values }),
+  });
+}
+
 export async function fetchMasterTree(): Promise<MasterGroup[]> {
   return (await request<{ groups: MasterGroup[] }>("/master-data/tree")).groups;
 }
 
-export function fetchMasterRows(query: {
-  file: string;
-  table: string;
-  page: number;
-  size: number;
-  q: string;
-}): Promise<MasterRows> {
-  const params = new URLSearchParams({
-    file: query.file,
-    table: query.table,
-    page: String(query.page),
-    size: String(query.size),
-    q: query.q,
-  });
+export function fetchMasterRows(
+  file: string,
+  table: string,
+  query: RowsQuery,
+): Promise<MasterRows> {
+  const params = new URLSearchParams({ file, table, ...pageParams(query) });
   return request<MasterRows>(`/master-data/rows?${params}`);
 }