chore(853-1): 갱신 절차에 빠진 빌더 적음 · 한 번용 뺀 절차와 맞춤 — 묶음 ⑥

- 더함: 수식 문서 절(build_수식문서_802_2 · --check) · 요율 책(build_제비율책) · 기계 작업량 채우기(build_기계_작업량_846_1) · 소요량 · 계수 용도 채우기(build_용도) · 로직 채우기 차례(build_변수표_796_3 → build_변수기호_800_1 → build_단위표기_801_5 → build_재료_검색어)
- 뺌: 요율 줄의 _migrate_base(묶음 ④ 에 걷음) · 품셈재료 절(첫 층에 없음 — 시험 기준 자료만)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 12:52:35 +09:00
co-authored by Claude Opus 5.5
parent 2925209dff
commit accedd34e8
+26 -11
View File
@@ -60,15 +60,10 @@
- 휘발유·경유는 옛 판 값 그대로 지님 — 새로 받아도 갱신 안 됨(빌더 안 새 판 반영 없음) — 구멍.
## 품셈재료 (`재료_품셈재료.json`)
## 품셈재료
| 항목 | 값 |
| --- | --- |
| 출처 | 품셈이 부르는 재료 — 산림품셈 · 건설품셈 본문 · `원가계산/산림_표준품셈/본문/` · `원가계산/건설공사_표준품셈/본문/` |
| 받는 법 | 손으로 줄 추가 · 연결(자재품목 키)은 M01 화면에서 사람이 이음 |
| 주기 | 품셈 개정 때 |
| 빌더 | 빌더 없음 |
| 검사 | `check_master.py 로직` (로직 재료 줄 고르기 조건) · `pytest resources/tester/test_자재품목_분류.py -q` (품셈재료가 부르는 재료의 묶음) |
- 첫 층에 없음 — `old/재료_품셈재료.json` 은 시험 기준 자료(`test_자재품목_분류.py`)로만 둠.
- 로직 재료 줄 = 자재품목 고르기 조건 · 검색어(아래 로직 채우기).
## 기계 (폴더 `기계/` = 한 대 한 파일 · 읽기 · 쓰기 `master_machine_files` · 원문 건설품셈 · 산림품셈)
@@ -77,6 +72,7 @@
| 건설품셈 | 건설품셈 공통 8-3 손료 · 8-4 운전경비 · 8-5 기계가격 · `원가계산/건설공사_표준품셈/본문/01_공통부문/제08장_건설기계/` | 한국표준품셈정보원 PDF — `collect_cost_sources.py docs` → md | 연 1회(품셈 개정) | `scripts/build_기계_건설품셈.py [--dry]` | `check_master.py 틀 기계.json` |
| 산림품셈 | 산림품셈 2장 기계손료 · `원가계산/산림_표준품셈/본문/제02장_소요재료_및_기계손료/` | 산림청 고시 PDF · md | 고시 개정 때 | 빌더 없음 | 같음 |
- 기계를 더하거나 규격을 고친 뒤 = `scripts/build_기계_작업량_846_1.py [--dry | --check]`(값 칸 `작업량` 채우기 · 다시 돌려도 같음).
- 운전경비의 환율·유가는 마스터가 아니라 로직이 환율·유가전력 줄을 부름.
## 소요량 (`소요량_<원문>_<NN>장_….json`)
@@ -98,6 +94,8 @@
| 산림 그 밖 장 | 산림품셈 본문 각 장 | 같음 | 같음 | 빌더 없음 | 같음 |
| 건설 전 장 | 건설품셈 본문 각 부문 | 같음 | 연 1회 | 빌더 없음(소요량 빌더 안 계수 손 표는 소요량에 들어감) | 같음 |
- 소요량 · 계수 표를 다시 지은 뒤 = `scripts/build_용도.py`(표마다 「용도」 · 다시 돌려도 같음).
## 환율 (`환율_한국은행환율.json`)
| 항목 | 값 |
@@ -115,8 +113,8 @@
| 출처 | 조달청제비율 · `행정규칙/토목공사원가계산 제비율 적용기준/첨부/*조달청_토목공사_제비율.xlsx` + 국민연금법 `법률/국민연금법/현행_*.xml` |
| 받는 법 | 조달청 고시 첨부 XLSX · 법령 XML 손으로 (`_pipeline/collect_law.py` 는 법령 쪽) |
| 주기 | 고시 개정 때(연 1~2회) · 국민연금 요율은 매년 |
| 빌더 | `scripts/build_요율.py --check`(대조만 · 정본 안 씀 · 다른 줄은 원문 셀 자리와 같이 나옴) — `scripts/_migrate_base.py` 는 옛 파일 한 번 옮기기 |
| 검사 | `build_요율.py --check` · `check_master.py 틀 요율_조달청제비율.json` |
| 빌더 | `scripts/build_요율.py --check`(대조만 · 정본 안 씀 · 다른 줄은 원문 셀 자리와 같이 나옴) · 요율 화면 책 = `scripts/build_제비율책.py`(→ `제비율엑셀/조달청_제비율_책.json` · 판마다) |
| 검사 | `build_요율.py --check` · `build_제비율책.py --check` · `check_master.py 틀 요율_조달청제비율.json` |
## 로직 (`로직_<원문>_<NN>장_….json`)
@@ -129,9 +127,26 @@
| 검사 | `check_master.py 로직` (끊긴 키 · 돌고 도는 참조 · 찾기 조건) · `check_master.py 계산 <로직키> 이름=값 …` (견본 계산) · `pytest resources/tester/test_masterdata_check.py resources/tester/test_m01_api.py -q` |
| 복잡도 | `scripts/로직_복잡도_재기.py [상위 N]` (읽기 전용) |
로직 줄을 더한 뒤 채우기(차례대로 · 모두 `--check` 로 남은 것만 봄 · 다시 돌려도 같음):
1. `scripts/build_변수표_796_3.py`(변수 국문 이름 · 기호 · 단위 — 결정 자료 `scripts/변수표_796_3.json`)
2. `scripts/build_변수기호_800_1.py`(남은 변수 기호)
3. `scripts/build_단위표기_801_5.py`(단위 글 원문 꼴)
4. `scripts/build_재료_검색어.py [--쓰기]`(재료 줄 자재품목 키 → 검색어)
## 수식 문서 (`수식문서/수식_<원문>_<NN>장_….json`)
| 항목 | 값 |
| --- | --- |
| 출처 | 로직 JSON(위) — 변환 `master_doc_convert` · 셈 `master_doc_calc` |
| 받는 법 | 로직 · 요소를 고친 뒤 빌더로 다시 지음 · 화면 [저장]은 문서에 바로 씀 |
| 주기 | 로직 · 요소 갱신 때 |
| 빌더 | `scripts/build_수식문서_802_2.py`(변환 · 금액 전수 대조 · 저장) |
| 검사 | `build_수식문서_802_2.py --check`(저장본 · 목록과 같음) · `pytest resources/tester/test_802_2_convert.py -q` |
## 구멍 목록
- 품셈재료 · 로직 — 빌더 없음.
- 로직 — 빌더 없음(채우기 · 수식 문서만).
- 요율 — 대조(`--check`)만 됨 · 값을 정본에 반영하는 쓰기는 여전히 손으로.
- 기계 산림품셈 · 소요량 건설 건축·유지관리 · 소요량 산림 전 장 · 계수 건설 전 장 · 계수 산림 1장 밖 — 빌더 없음.
- 자재품목 — 나라장터 스냅샷 → 마스터 줄 빌더 없음 · 유료 물가지 받는 길 미정.