전력: 한전 사이버지점 전기공급약관 별표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
281 lines
10 KiB
TypeScript
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 };
|
|
}
|