Files
Aislo/resources/master_data/scripts/master_keys.py
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

411 lines
16 KiB
Python

# -*- coding: utf-8 -*-
"""마스터 키 — 테이블ID(영문 대문자 2) + 6자리 일련번호 · 대장 `_키대장.json` (`_틀.md` 2장).
한 번 준 키는 안 바뀜 · 새 줄은 대장의 다음 번호. 원문이 준 번호·옛 열쇠는 줄의 「원문번호」.
"""
from __future__ import annotations
import json
import re
from decimal import Decimal
from pathlib import Path
MASTER = Path(__file__).resolve().parent.parent
BOOK = MASTER / "_키대장.json"
KEY = re.compile(r"[A-Z]{2}\d{6}")
# (그룹, 원문) → 테이블ID · 인력·기계는 원문 구분 없이 한 테이블
TABLES = {
("인력", None): "LB",
("재료", "자재품목"): "MT",
("재료", "유가전력"): "MO",
("재료", "품셈재료"): "MP",
("기계", None): "EQ",
("소요량", "산림품셈"): "QF",
("소요량", "건설품셈"): "QC",
("계수", "산림품셈"): "CF",
("계수", "건설품셈"): "CC",
("환율", "한국은행환율"): "FX",
("요율", "조달청제비율"): "RT",
("로직", "산림품셈"): "GF",
("로직", "건설품셈"): "GC",
("로직", "자체"): "GX",
}
GROUP_OF = {tid: group for (group, _), tid in TABLES.items()}
IDS = tuple(GROUP_OF)
def table_id(group: str, book: str | None) -> str:
return TABLES.get((group, None)) or TABLES[(group, book)]
def id_of(ref: str) -> str:
"""키·「ID:원문번호」 의 테이블ID — 모르면 ""."""
return ref[:2] if ref[:2] in GROUP_OF else ""
SECTION = re.compile(r"^(?:(?:공통|토목|건축|기계설비|유지관리)\s+)?(\d+(?:-\d+)*[가-힣]?)(?:\s|$)")
def section_no(number: str) -> str:
"""줄에 적는 원문번호 — 절 번호만(부문·제목 뗌) · 절 번호 모양이 아니면 그대로."""
m = SECTION.match(str(number))
return m.group(1) if m else str(number)
def load_book(path: Path = BOOK) -> dict:
if path.is_file():
return json.loads(path.read_text(encoding="utf-8"))
return {"다음": {}, "키": {}}
def save_book(book: dict, path: Path = BOOK) -> None:
"""키 한 줄씩 — 머리 「다음」 뒤에 키 차례대로."""
lines = ["{", ' "다음": ' + json.dumps(book["다음"], ensure_ascii=False) + ","]
if book.get("폐기"):
lines.append(' "폐기": ' + json.dumps(book["폐기"], ensure_ascii=False) + ",")
lines.append(' "키": {')
items = sorted(book["키"].items())
for i, (key, v) in enumerate(items):
comma = "," if i < len(items) - 1 else ""
lines.append(f" {json.dumps(key)}: {json.dumps(v, ensure_ascii=False)}{comma}")
lines += [" }", "}"]
path.write_text("\n".join(lines) + "\n", encoding="utf-8", newline="\n")
def lookup(book: dict) -> dict:
"""(테이블ID, 원문번호) → 키 — 대장에서 한 번 세워 둠(`finish` 가 걷음)."""
index = book.setdefault("_찾기", {})
if not index:
for key, v in book["키"].items():
index[(key[:2], v["원문번호"])] = key
return index
def issue(book: dict, tid: str, number: str, file: str) -> str:
"""(테이블ID, 원문번호) 의 키 — 대장에 있으면 그 키 · 없으면 다음 번호(원문번호 빈 새 줄 포함)."""
index = lookup(book)
key = index.get((tid, number)) if number else None
if key:
book["키"][key]["파일"] = file
return key
n = book["다음"].get(tid, 1)
key = f"{tid}{n:06d}"
book["다음"][tid] = n + 1
book["키"][key] = {"원문번호": number, "파일": file}
index[(tid, number)] = key
return key
def finish(book: dict) -> dict:
book.pop("_찾기", None)
return book
def stamp(
book: dict, tid: str, rows: list[dict], file: str, extra: dict | None = None
) -> list[dict]:
"""빌더가 만든 줄(「열쇠」) → 「키」 · 「원문번호」(절 번호만) · extra 칸을 앞에 둔 줄.
대장은 옛 열쇠(부문·제목까지)를 그대로 지님 — 키를 다시 찾는 열쇠라서."""
out = []
for row in rows:
row = dict(row)
number = str(row.pop("열쇠", row.get("원문번호")))
row.pop("원문번호", None)
key = row.pop("키", None) or issue(book, tid, number, file)
out.append({"키": key, "원문번호": section_no(number), **(extra or {}), **row})
return out
# ── 빌더 잇기 — 빌더는 옛 모양(「열쇠」 · 원문별 파일 이름)으로 쓰고 adopt 가 새 틀로 받음 ──
LABOR = {
"건설노임": "건설업",
"제조노임": "제조업",
"엔지니어링노임": "엔지니어링",
"측량노임": "측량",
"건설사업관리노임": "건설사업관리",
"SW노임": "SW",
"산림노임": "산림",
"준용대상": "미확보",
}
MERGED = {
"인력": ("인력.json", "구분", LABOR),
"기계": ("기계.json", "세부분류", {"건설품셈": "건설품셈", "산림품셈": "산림품셈"}),
}
DIVISIONS = ("공통", "토목", "건축", "기계설비", "유지관리")
# 장 파일 줄의 열 차례 — 앞 넷은 한 줄에 · 「그룹」(소요량 파일 안의 계수 표 표시)은 맨 뒤
ROW_ORDER = {
"표": (
"키",
"원문번호",
"구분",
"상세구분",
"이름",
"기준",
"출처",
"비고",
"조건",
"범위규칙",
"값칸",
"줄",
"주",
"그룹",
),
"로직": (
"키",
"원문번호",
"구분",
"상세구분",
"이름",
"결과단위",
"출처",
"소유",
"비고",
"입력",
"중간",
"호표",
"덧줄",
"결과",
"끝수",
),
}
OLD_CHAPTER = re.compile(r"^(소요량|계수|로직)_(산림품셈|건설품셈)_(\D*)(\d+)장\.json$")
CHAPTER = re.compile(r"^(소요량|계수|로직)_(산림품셈|건설품셈|자체)_(\d\d)장_.+\.json$")
_BODY = MASTER.parents[1] / "resources/knowledge/original/원가계산"
_OLDREF = re.compile(r"(인력|재료|기계|소요량|계수|로직|환율|요율):([^:\s·]+):(.+?)(?=\s·\s|$)")
_STR = re.compile(r'"(?:[^"\\]|\\.)*"')
def title(book: str, division: str, number: int) -> str:
"""원문 장 제목 — 본문 폴더 이름 그대로(「제07장_지붕_및_홈통공사」 → 「지붕_및_홈통공사」)."""
base = _BODY / "산림_표준품셈/본문"
if book == "건설품셈":
index = DIVISIONS.index(division) + 1
base = _BODY / "건설공사_표준품셈/본문" / f"{index:02d}_{division}부문"
(hit,) = base.glob(f"제{number:02d}장_*")
return hit.name.split("_", 1)[1]
def detail_of(name: str) -> str:
"""장 파일 이름 → 상세구분 「03장 토공사」."""
return name.removesuffix(".json").split("_", 2)[2].replace("_", " ")
def chapter_file(group: str, book: str, division: str, number: int) -> str:
return f"{group}_{book}_{number:02d}장_{title(book, division, number)}.json"
def _items(data: dict) -> str:
return "표" if data.get("그룹") in ("소요량", "계수") else "줄"
def _read(path: Path, exact: bool = True) -> dict:
text = path.read_text(encoding="utf-8")
return json.loads(text, parse_float=Decimal, parse_int=Decimal) if exact else json.loads(text)
def old_view(name: str, folder: Path = MASTER) -> dict:
"""옛 파일 이름으로 읽기(빌더용 · 수는 float) — 줄의 「열쇠」 = 원문번호 · 키·갈래 칸 뺌.
준용·연결 같은 참조는 키 그대로."""
m = re.match(r"^(인력|기계)_(.+)\.json$", name)
if m:
file, slot, labels = MERGED[m.group(1)]
data = _read(folder / file, exact=False)
label = labels[m.group(2)]
head = {"그룹": m.group(1), **data[slot][label]}
rows = [r for r in data["줄"] if r.get(slot) == label]
else:
c = OLD_CHAPTER.match(name)
path = folder / (chapter_file(c[1], c[2], c[3], int(c[4])) if c else name)
data = _read(path, exact=False)
head, rows, slot = (
{k: v for k, v in data.items() if k != _items(data)},
data[_items(data)],
"",
)
drop = ("키", "원문번호", slot)
out = [{"열쇠": r["원문번호"], **{k: v for k, v in r.items() if k not in drop}} for r in rows]
return {**head, _items(head): out}
def _old_ref(book: dict, text: str) -> str:
"""옛 참조 `그룹:원문:열쇠` → 키(대장에 없으면 그대로 — check_master 가 잡음)."""
group, src, number = (text.split(":", 2) + ["", ""])[:3]
try:
tid = table_id(group, src)
except KeyError:
return text
return lookup(book).get((tid, number), text)
def _convert(book: dict, row: dict, names: dict) -> dict:
"""줄 속 옛 참조 — 준용 · 후보 글(키 옆 이름) · 품셈재료 연결."""
for col in ("준용",):
value = row.get(col)
if isinstance(value, str) and ":" in value:
row[col] = _old_ref(book, value)
if isinstance(row.get("후보"), str):
def one(m):
key = _old_ref(book, m.group(0))
return f"{key} {names.get(key, m.group(3))}" if KEY.fullmatch(key) else key
row["후보"] = _OLDREF.sub(one, row["후보"])
link = row.get("연결")
if isinstance(link, str) and not KEY.fullmatch(link):
row["연결"] = lookup(book).get(("MT", link), link)
return row
def _store():
import sys
sys.path.insert(0, str(MASTER.parents[1]))
from M01_MasterData import M01_MasterData_Store as st
return st
def dump_rows(head: dict, rows: list[dict]) -> str:
"""요소 파일 — 머리는 들여쓰기 2칸 · 줄은 한 줄씩(길면 펼침)."""
st = _store()
out = ["{"] + [f" {st._atom(k)}: {st.dump(v, 2)}," for k, v in head.items()]
out.append(' "줄": [')
for i, row in enumerate(rows):
line = st._flat(row)
body = line if len(line) <= 450 else st.dump(row, 4, expand=True)
out.append(" " + body + ("," if i < len(rows) - 1 else ""))
return "\n".join(out + [" ]", "}"]) + "\n"
def keep_text(text: str, old: dict, new: dict) -> str | None:
"""글 모양 그대로 — 「열쇠」 칸(키·원문번호·갈래) · 바뀐 글 · 머리 부문·차례만 갈음 · 다르면 None."""
rows_old, rows_new = old[_items(old)], new[_items(new)]
spots = list(re.finditer(r'"열쇠": ("(?:[^"\\]|\\.)*"|[-\d.]+)', text))
if len(spots) != len(rows_new):
return None
parts, at = [], 0
for m, row in zip(spots, rows_new):
head = [k for k in ("키", "원문번호", "구분", "상세구분") if k in row]
line = ", ".join(f'"{k}": {json.dumps(row[k], ensure_ascii=False)}' for k in head)
parts += [text[at : m.start()], line]
at = m.end()
text = "".join(parts) + text[at:]
swap = {}
for a_row, b_row in zip(rows_old, rows_new):
for k in b_row:
if k in a_row and a_row[k] != b_row[k]:
for a, b in zip(_strings(a_row[k]), _strings(b_row[k])):
if a != b:
swap[json.dumps(a, ensure_ascii=False)] = json.dumps(b, ensure_ascii=False)
text = _STR.sub(lambda m: swap.get(m.group(0), m.group(0)), text)
add = "".join(
f" {json.dumps(k, ensure_ascii=False)}: {_store()._atom(new[k])},\n"
for k in ("부문", "차례")
if k in new and k not in old
)
if add:
text = re.sub(r'(\n "원문": "[^"]*",\n)', lambda m: m.group(1) + add, text, count=1)
same = json.loads(text, parse_float=Decimal, parse_int=Decimal) == new
return text if same else None
def _strings(v):
if isinstance(v, str):
yield v
elif isinstance(v, dict):
for x in v.values():
yield from _strings(x)
elif isinstance(v, list):
for x in v:
yield from _strings(x)
def order_chapters(folder: Path = MASTER) -> None:
"""장 파일 머리 「차례」 — 그룹마다 산림 1~14장 → 건설 공통 · 토목 · 건축 · 기계설비 · 유지관리."""
found = {}
for path in folder.glob("*.json"):
m = CHAPTER.match(path.name)
if m:
data = _read(path)
division = data.get("부문") or ""
rank = (m[2] != "산림품셈", DIVISIONS.index(division) if division else -1, int(m[3]))
found.setdefault(m[1], []).append((rank, path.name, data.get("차례")))
for items in found.values():
for i, (_, name, had) in enumerate(sorted(items), start=1):
if had != i:
path = folder / name
text = re.sub(
r'"차례": \d+', f'"차례": {i}', path.read_text(encoding="utf-8"), count=1
)
path.write_text(text, encoding="utf-8", newline="\n")
def adopt(folder: Path = MASTER) -> list[str]:
"""빌더가 옛 모양으로 쓴 파일 → 새 틀(키 · 원문번호 · 한 테이블 · 장 파일 이름) · 옛 파일은 지움.
키는 대장의 (테이블ID, 원문번호) 키 · 없으면 다음 번호. 로직은 키로 적어 넣으므로 받지 않음."""
book = load_book(folder / BOOK.name)
names = {}
if (folder / "인력.json").is_file():
names = {r["키"]: r.get("이름") for r in _read(folder / "인력.json")["줄"]}
done = []
for path in sorted(folder.glob("*.json")):
if path.name.startswith("_"):
continue
data = _read(path)
rows = data.get(_items(data)) or []
if not rows or "열쇠" not in rows[0]:
continue
group, src = data["그룹"], data["원문"]
if group == "로직":
raise SystemExit(f"{path.name} · 로직은 키로 적음 — 옛 모양은 받지 않음")
c = OLD_CHAPTER.match(path.name)
target = chapter_file(c[1], c[2], c[3], int(c[4])) if c else path.name
target = MERGED[group][0] if group in MERGED else target
if c and c[3]: # 건설품셈 원문번호 앞에 부문(「기계설비 7-1-1 …」)
head = c[3] + " "
rows = [
r if str(r["열쇠"]).startswith(head) else {**r, "열쇠": head + r["열쇠"]}
for r in rows
]
data[_items(data)] = rows
# 장 파일 줄은 갈래를 스스로 지님 — 구분 = 원문 + 부문 · 상세구분 = 「NN장 장 제목」
extra = (
{"구분": " ".join(x for x in (src, c[3]) if x), "상세구분": detail_of(target)}
if c
else None
)
stamped = [
_convert(book, r, names) for r in stamp(book, table_id(group, src), rows, target, extra)
]
if group in MERGED:
file, slot, labels = MERGED[group]
label = labels[src]
whole = _read(folder / file) if (folder / file).is_file() else {"그룹": group}
heads = whole.setdefault(slot, {})
heads[label] = {k: v for k, v in data.items() if k not in ("그룹", "줄")}
stamped = [
{"키": r["키"], "원문번호": r["원문번호"], slot: label, **r} for r in stamped
]
keep = [r for r in whole.get("줄", []) if r.get(slot) != label]
rows_all = sorted(keep + stamped, key=lambda r: r["키"])
text = dump_rows({k: v for k, v in whole.items() if k != "줄"}, rows_all)
else:
head = {"그룹": group, "원문": src}
if c and c[3]:
head["부문"] = c[3]
if c:
head["차례"] = Decimal(0) # order_chapters 가 채움
rest = {k: v for k, v in data.items() if k not in head}
new = {**head, **rest, _items(data): stamped}
old_text = path.read_text(encoding="utf-8")
text = keep_text(old_text, data, new) or _store().dump(new)
(folder / target).write_text(text, encoding="utf-8", newline="\n")
if target != path.name:
path.unlink()
done.append(target)
save_book(finish(book), folder / BOOK.name)
order_chapters(folder)
return done