feat(master_data): 요소·일위대가 로직 파일 틀 초안

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QqkvdyxUtANWroVKpQUyxE
2026-09-19 15:25:08 +09:00
parent c250e00e00
commit 291e8a8cfe
1 changed files with 106 additions and 0 deletions
@@ -0,0 +1,106 @@
+# 마스터 데이터 파일 틀
+
+`resources/master_data/` 첫 층 = 정본. `old/` · `ref/` 는 읽지 않음.
+
+## 1. 용어
+
+- **요소** = 원문에 적힌 이름·수 그대로. 계산하지 않음.
+- **일위대가 로직** = 요소를 변수로 끌어와 조립한 단위당 계산법. 설계 값 자리는 비움.
+- 다른 것을 끌어와 계산하면 로직(기계 시간당 경비 · 기계 작업량 식 포함).
+
+## 2. 파일
+
+- 이름 = `그룹_원문[_장].json` — 날짜 없음 · 마스터는 항상 최신. 예: `인력_건설노임.json` · `소요량_산림품셈_13장.json` · `로직_산림품셈_13장.json`
+- 그룹 = 인력 · 재료 · 기계 · 소요량 · 계수 · 환율 · 요율 · 로직
+- 원문 이름 = 산림품셈 · 건설품셈 · 건설노임 · 제조노임 · 나라장터자재 · 오피넷유가 · 한국은행환율 · 조달청제비율 · 자체
+- UTF-8 · LF · 들여쓰기 2칸 · 칸 이름은 한글.
+
+## 3. 출처
+
+- 한 칸 · `원문 이름 + 번호` — 「산림품셈 13-4-1」 · 「건설품셈 공통 8-4-1」(건설은 부문 필수) · 「건설노임 1018」 · 「자체」
+- [주] 는 뒤에 붙임 — 「산림품셈 13-4-4 주⑩」
+- 판(기준일)은 파일 머리에 한 번.
+
+## 4. 요소 파일
+
+```json
+{
+  "그룹": "인력",
+  "원문": "건설노임",
+  "판": "2026-01-01",
+  "줄": [
+    { "열쇠": "1018", "이름": "포설공", "규격": "", "단위": "원/일", "값": 0, "출처": "건설노임 1018" }
+  ]
+}
+```
+
+- `열쇠` = 원문이 준 번호(직종 번호 · 물품 번호 · 기계 분류번호 `0201-0070`). 없으면 이름.
+- 값이 여럿인 요소(기계)는 `값` 을 묶음으로 — `{ "가격": …, "손료계수": …, "주연료": …, "잡재료율": …, "조종원": … }` · 칸마다 온 절이 다르면 `출처` 도 같은 모양의 묶음.
+- 원문에 없는 값을 지어 넣지 않음. 원문 「-」 = 칸을 비움(`null`).
+
+## 5. 표형 요소 (소요량 · 계수)
+
+원문 표 하나 = 표 하나. 머리가 여러 단이어도 **조건 칸 + 값 칸의 긴 줄**로 폄.
+
+```json
+{
+  "열쇠": "13-4-1 메쌓기",
+  "이름": "메쌓기(인력)",
+  "기준": "1㎡",
+  "출처": "산림품셈 13-4-1",
+  "조건": { "뒷길이": "수", "돌": "고르기", "쌓기": "고르기" },
+  "값칸": { "석공": "인", "보통인부": "인" },
+  "줄": [
+    { "뒷길이": 35, "돌": "견치돌", "쌓기": "골쌓기", "석공": 0.5, "보통인부": 0.4 }
+  ],
+  "주": ["① …"]
+}
+```
+
+- 조건 종류 — `수`(같은 값) · `고르기`(글자) · `범위`(줄에 `[아래, 위]` · 끝 열림은 `null` · 포함 여부는 `범위규칙` 에 「초과·이하」처럼).
+- 원문 「-」 칸은 줄에서 그 값 칸을 뺌. 줄 전체가 「-」 면 줄을 뺌.
+- 수는 원문 그대로(쉼표만 뺌). 단위 환산하지 않음.
+- `주` 는 원문 글 그대로 — 계산에 쓰는 수가 들어 있으면 따로 계수 표로도 올림.
+
+## 6. 로직 파일
+
+```json
+{
+  "그룹": "로직",
+  "원문": "산림품셈",
+  "줄": [
+    {
+      "열쇠": "13-4-1 메쌓기",
+      "이름": "돌쌓기 메쌓기(인력)",
+      "결과단위": "원/㎡",
+      "출처": "산림품셈 13-4-1",
+      "소유": "공용",
+      "입력": [
+        { "이름": "뒷길이", "단위": "㎝" },
+        { "이름": "돌", "고르기": ["견치돌", "깬돌", "깬잡석", "호박돌 및 야면석"] }
+      ],
+      "중간": [{ "이름": "증가율", "식": "…" }],
+      "호표": [
+        { "종류": "인력", "요소": "인력:건설노임:…", "단위": "인", "수량": "…", "비목": "노무비" }
+      ],
+      "덧줄": [{ "이름": "잡재료비", "식": "노무비 * 0.05", "비목": "재료비", "출처": "…" }],
+      "끝수": "원 미만 버림"
+    }
+  ]
+}
+```
+
+- `호표` 줄 = 실무 일위대가표 한 줄(종류 · 이름·규격 · 단위 · 수량 · 단가 · 금액). 단가는 적지 않음 — `요소` 에서 옴. 금액 = 수량 × 단가.
+- `종류` = 인력 · 재료 · 기계 · 로직(하위 로직의 결과를 단가로 씀).
+- `비목` = 노무비 · 재료비 · 경비. `덧줄` 식에서 비목 합을 이름으로 씀.
+- `결과단위` 가 돈이 아닌 로직(㎥/시간)은 `호표` 없이 `중간` + `결과` 식.
+- `소유` = 공용 · 개인(뒤 단계 자리).
+
+## 7. 변수 · 식
+
+- 요소 — `그룹:원문:열쇠` · 값 묶음은 `.칸` — `기계:건설품셈:0201-0070.주연료`
+- 표 찾기 — `찾기(소요량:산림품셈:13-4-1 메쌓기, 뒷길이=뒷길이, 돌=돌, 쌓기=쌓기).석공`
+- 로직 부르기 — `로직(건설품셈:8 굴착기 시간당 경비, 규격=0.7)`
+- 입력 · 중간 · 비목 합은 이름 그대로.
+- 쓸 수 있는 것 — `+ - * /` · 괄호 · `찾기` · `로직` · `만약(조건, 참, 거짓)` · `올림` `버림` `반올림`(자리) · `최소` `최대`. 그 밖은 쓰지 않음.
+- 로직이 돌고 도는 참조를 만들지 않음.