Files
Aislo/M01_MasterData/M01_MasterData_UI_Side.ts
T
eomsangdonandClaude Sonnet 5 cabc7e68d2 knowledge(유가전력): 실내등유 오피넷 수집 + 한전 전기요금표 별표1 확보 · 재료_유가전력.json 신설
전력: 한전 사이버지점 전기공급약관 별표1(월간 전기요금표, 2025-01-01 시행 (C)판)을
resources/knowledge/original/원가계산/전기요금_한국전력/20250101/ 에 원문·완전 md화로
보관. 건설품셈 1-5-2호·산림품셈 1-7-2호·계약예규 예정가격작성기준 §19·§34를 대조 —
전력비를 어느 계약종별로 계상하라는 조문은 없음(전부 「실비 계상」만 규정) — 지어내지
않고 마스터 비고에 그대로 기록.

실내등유: 오피넷 OpenAPI 제품코드 C004를 collect_cost_sources.py 시도별 수집 루프에
추가(전국평균은 avgAllPrice 응답에 이미 포함되어 있어 코드 변경 불요). 오늘 자로 실제
수집해 유가_전국평균_2026-09-20.json · 유가_시도별_2026-09-20.json 저장.

마스터: 재료_오피넷유가.json → 재료_유가전력.json(테이블ID MO 그대로, 키 이어받기·
_키대장 다음 번호 37부터 신규 36줄). 기존 휘발유·경유 36줄은 로직 계산 결과가 갈리지
않도록 옛 판(2026-08-14/09-09) 값을 그대로 지니고, 구분 칸만 전국평균/시도별→유류로
바꿈. 실내등유 18줄(전국평균+17개 시도)과 전력 18줄(주택용·일반용(갑)Ⅰ·산업용(갑)Ⅰ
저압·임시전력(갑) 저압 위주 주요 계약종별)을 새로 추가. 파일 머리에 「구분」 등록부
(유류/전력 각각 원문·기관·판·지식DB 경로)를 둬 M01 /subs 가 두 갈래를 갈래대로 보게 함.
재료_유가전력.json을 만드는 build_재료_유가전력.py 신설(다음부터 이 스크립트로 갱신).

파일 이름·원문 규칙에 맞춰 master_keys.py·check_master.py의 "오피넷유가" 키를
"유가전력"으로, M01_MasterData_UI_Side.ts의 재료 탭 이름도 같이 고침 — 로직의
MO:{연료}:{지역} 참조는 원문번호로만 찾아 영향 없음(로직 파일은 손대지 않음).

검증: check_master 틀 0건(전체) · 로직 0건(전체) · test_masterdata_check·test_m01_api·
test_b09_fuel_region 73건 전부 통과(계산 결과 전후 동일 확인).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WaS48Nvs26o3aFUpcfJxVv
2026-09-20 18:44:21 +09:00

281 lines
10 KiB
TypeScript

/* =============================================================================
* M01_MasterData_UI_Side.ts
* 왼쪽 패널 — 공용 접기 컨테이너(`ui-collapsible ui-sidebar-section`) 여덟 개
* 인력 · 재료 · 기계 · 소요량 · 계수 · 환율 · 요율 · 일위대가 로직
* 펼치면 하위 목록(거름 · 파일) · 환율/요율은 누르면 바로 표 · 로직은 안에 로직 목록
* ========================================================================== */
import { createSelectField, el, showToast } from "@ui/ui_template_elements";
import { attachCollapsible } from "@ui/ui_template_collapsible";
import { t as L } from "@ui/ui_template_locale";
import { fetchFiles, fetchSubs, type FileInfo, type SubInfo } from "./M01_MasterData_Api_Fetch";
import { renderTree, type MakeRow } from "./M01_MasterData_UI_Tree";
/** 요소 화면에서 열 것 — 파일 · 하위 거름(구분·세부분류) · 상세구분 · 제목 */
export interface Pick {
group: string;
file: FileInfo;
sub: string;
detail: string;
label: string;
}
export interface SideHandle {
root: HTMLElement;
/** 일위대가 로직 컨테이너 안(로직 목록이 들어갈 자리) */
logicHost: HTMLElement;
/** 그룹의 파일 판본을 다시 받음(저장 뒤) — 돌려받는 것 = 새 목록 */
refresh: (group: string) => Promise<FileInfo[]>;
setActive: (id: string | null) => void;
/** 「전체」 + 드롭다운 거름 한 벌 — 로직 컨테이너도 씀 */
filter: (args: FilterArgs) => HTMLElement;
}
export interface FilterArgs {
/** 「전체」 줄 눌림 표시용 */
id: string;
/** 고른 것을 기억할 sessionStorage 칸 */
store: string;
subs: SubInfo[];
total: number;
subLabel: string;
/** 없으면 한 단 */
detailLabel?: string;
onPick: (sub: string, detail: string, label: string) => void;
}
const MATERIAL_NAMES: Record<string, string> = { 유가전력: "유가·전력" };
/** 재료 컨테이너 차례 — 여기 없는 파일은 뒤에 */
const MATERIAL_ORDER = ["자재품목", "유가전력", "품셈재료"];
/** 파일 이름 → 목록 글자 — 「소요량_건설품셈_10장_창호…」 → 「건설품셈_10장_창호…」 */
export const fileLabel = (file: string): string =>
file.replace(/^[^_]+_/, "").replace(/\.json$/, "");
const GROUP_TITLE = {
인력: "M01_GroupLabor",
재료: "M01_GroupMaterial",
기계: "M01_GroupMachine",
소요량: "M01_GroupQuantity",
계수: "M01_GroupFactor",
환율: "M01_GroupExchange",
요율: "M01_GroupRate",
} as const;
type Group = keyof typeof GROUP_TITLE;
const GROUPS = Object.keys(GROUP_TITLE) as Group[];
const LEAF: Group[] = ["환율", "요율"];
export function buildSide(onOpen: (pick: Pick) => void, onLogic: () => void): SideHandle {
const lists = new Map<Group, FileInfo[]>();
const bodies = new Map<Group, HTMLElement>();
const buttons = new Map<string, HTMLElement>();
// 하위 거름은 서버가 준 목록(파일 머리에 등록된 구분·세부분류) — 새 조사가 늘어도 화면은 그대로
const kinds = new Map<Group, SubInfo[]>();
const setActive = (id: string | null): void => {
for (const [key, button] of buttons) button.classList.toggle("is-active", key === id);
};
/** 트리 줄 — 부모는 접기/펴기 · 누를 일이 있는 줄만 밝게 */
const make: MakeRow = (node, caret, depth, onClick) => {
const button = el("button", {
className: "m01-side__item",
attrs: { type: "button" },
children: [
el("span", {
children: [
el("span", { className: "m01-tree__caret", text: caret }),
el("span", { text: node.label }),
],
}),
...(node.count === null
? []
: [
el("span", {
className: "m01-side__muted",
text: node.count.toLocaleString("ko-KR"),
}),
]),
],
});
button.style.paddingLeft = `calc(var(--spacing-8) + ${depth} * var(--spacing-16))`;
if (node.run) buttons.set(node.id, button);
button.addEventListener("click", () => {
if (node.run) setActive(node.id);
onClick();
});
return button;
};
/** 「전체」 한 줄 + 구분 → 상세구분 드롭다운 거름(목록은 서버가 준 것 · 고른 것은 기억) —
* detailLabel 없으면 한 단 */
const filter = (a: FilterArgs): HTMLElement => {
const saved = (() => {
try {
return JSON.parse(sessionStorage.getItem(a.store) ?? "[]") as string[];
} catch {
return [];
}
})();
const pickSub = a.subs.find((k) => k.name === saved[0]);
const opts = (values: string[]): { value: string; text: string }[] =>
[L("M01_All"), ...values].map((v, i) => ({ value: i ? v : "", text: v }));
const sub = createSelectField({
options: opts(a.subs.map((k) => k.name)),
value: pickSub?.name ?? "",
compact: true,
label: a.subLabel,
});
const detail = a.detailLabel
? createSelectField({
options: opts(pickSub?.details ?? []),
value: saved[1] ?? "",
compact: true,
label: a.detailLabel,
disabled: !pickSub?.details.length,
})
: null;
const run = (): void => {
const d = detail?.select.value ?? "";
try {
sessionStorage.setItem(a.store, JSON.stringify([sub.select.value, d]));
} catch {
/* 기억 못 해도 거름은 됨 */
}
setActive(a.id);
a.onPick(
sub.select.value,
d,
[sub.select.value, d].filter(Boolean).join(" · ") || L("M01_All"),
);
};
sub.select.addEventListener("change", () => {
if (detail) {
const details = a.subs.find((k) => k.name === sub.select.value)?.details ?? [];
detail.setOptions(opts(details), "");
detail.select.disabled = details.length === 0;
}
run();
});
detail?.select.addEventListener("change", run);
const all = make({ id: a.id, label: L("M01_All"), count: a.total, run }, "", 0, () => {
sub.select.value = "";
sub.select.dispatchEvent(new Event("change"));
});
return el("div", {
children: [
all,
el("div", {
className: "m01-side__filter",
children: [sub.root, ...(detail ? [detail.root] : [])],
}),
],
});
};
const order = (file: string): number => {
const i = MATERIAL_ORDER.indexOf(fileLabel(file));
return i < 0 ? MATERIAL_ORDER.length : i;
};
const drawGroup = (group: Group): void => {
const files = lists.get(group) ?? [];
const body = bodies.get(group);
if (!body) return;
const open = (file: FileInfo, sub: string, label: string, detail = ""): void =>
onOpen({ group, file, sub, detail, label });
const one = files[0];
const dropped: Partial<Record<Group, { label: string; detail?: string }>> = {
인력: { label: L("M01_LaborSub"), detail: L("M01_LaborDetail") },
기계: { label: L("M01_MachineSub") },
소요량: { label: L("M01_LaborSub"), detail: L("M01_LaborDetail") },
계수: { label: L("M01_LaborSub"), detail: L("M01_LaborDetail") },
};
const drop = dropped[group];
if (drop && one) {
body.replaceChildren(
filter({
id: `${group}|`,
store: `m01.filter.${group}`,
subs: kinds.get(group) ?? [],
total: files.reduce((n, f) => n + f.rows, 0),
subLabel: drop.label,
detailLabel: drop.detail,
onPick: (sub, detail, label) => open(one, sub, label, detail),
}),
);
return;
}
body.replaceChildren(
...renderTree(
[...files]
.sort((a, b) => order(a.file) - order(b.file))
.map((f) => {
const name = fileLabel(f.file);
const label = group === "재료" ? (MATERIAL_NAMES[name] ?? name) : name;
return {
id: `${group}\n${f.file}`,
label,
count: f.rows,
run: () => open(f, "", label),
};
}),
make,
),
);
};
const refresh = async (group: string): Promise<FileInfo[]> => {
const list = await fetchFiles(group);
if (list[0] && (group === "인력" || group === "기계")) {
kinds.set(group, await fetchSubs({ file: list[0].file }));
} else if (group === "소요량" || group === "계수") {
kinds.set(group, await fetchSubs({ group }));
}
lists.set(group as Group, list);
drawGroup(group as Group);
return list;
};
const section = (title: string, body: HTMLElement | null): HTMLElement =>
el("section", {
className: "m01-side__group ui-collapsible ui-sidebar-section is-collapsed",
children: [
el("h3", { className: "ui-collapsible__title", text: title }),
...(body ? [body] : []),
],
});
const groups = GROUPS.map((group) => {
const body = LEAF.includes(group) ? null : el("div", { className: "m01-side__items" });
if (body) bodies.set(group, body);
const root = section(L(GROUP_TITLE[group]), body);
if (!body) {
root.classList.add("m01-side__leaf");
buttons.set(`${group}\n`, root);
root.querySelector(".ui-collapsible__title")?.addEventListener("click", () => {
const one = lists.get(group)?.[0];
if (!one) return;
setActive(`${group}\n`);
onOpen({ group, file: one, sub: "", detail: "", label: L(GROUP_TITLE[group]) });
});
}
return root;
});
const logicHost = el("div", { className: "m01-side__items" });
const logic = section(L("M01_GroupLogic"), logicHost);
logic.querySelector(".ui-collapsible__title")?.addEventListener("click", () => {
setActive(null);
onLogic();
});
const root = el("div", { className: "m01-side", children: [...groups, logic] });
attachCollapsible(root);
void Promise.all(GROUPS.map(refresh)).catch((error) =>
showToast(error instanceof Error ? error.message : L("M01_LoadFailed"), "error"),
);
return { root, logicHost, refresh, setActive, filter };
}