chore(plan): 받기 앞 공용 진단 문서를 dev 와 같은 내용으로 등록 (blob 9ed418e8 대조 일치)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016VBGFXB9AbJBwXP19z75Qq

docs/raw/verification/2026-09-13_축C_자재0과_못맞춘줄_진단.md

@@ -0,0 +1,121 @@
+# 축 C 1장 — 자재 0 과 못 맞춘 줄 진단
+
+작성 2026-09-13 · **랩탑 메인** · 읽기 전용 진단(코드 무변경) · 앞 조사 `2026-09-13_축C_공종이름잇기_전수조사.md` 의 이어짐
+
+> **방법** — 지금 코드·지금 마스터로 `build_resource_axis` 를 메모리에서 돌림(쓰기 없음).
+> 진단 스크립트는 세션 임시 폴더에만 두었음 — 같은 수치를 다시 내려면 이 문서의 기준을 따르면 됨.
+> **기준** — 공종 마스터 477공종·456표 · 카탈로그 = 노임 132 + 기계 613 + 관급 자재 6,999 ·
+> STmate 목록 `…/STmate 분석/30_원자료/stmate_code_name_list.csv`(M 228 · X 96 · L 37).
+
+---
+
+## 0. 한눈에
+
+| 물음 | 답 |
+| --- | --- |
+| 자재가 왜 0 인가 | **사급 자재 카탈로그가 아예 없음.** 합친 카탈로그의 자재는 **관급(나라장터) 6,999건뿐**이고 품셈 자재(종자·비료·결속선·못·폭약)는 사급이라 이름부터 없음 |
+| 못 맞춘 508 중 임도가 쓰는 공종 몫 | **138줄 · 42공종** (임도가 쓰는 코드 60개 기준). 나머지 370줄은 조림·방제·벌채 장 |
+| 138 중 진짜 자원 이름 | **약 40종** — 나머지는 표의 갈래 딱지(보통암·깨기·치즐소모량·토질 이름)를 이름으로 읽은 것 = **표 읽기 문제** |
+| STmate 목록이 풀어 주는 몫 | 40종 중 **이름이 겹치는 것 13종**, 그중 품셈 칸 규격만으로 1건이 정해지는 것 **거의 없음** — 규격은 **설계가 골라야 함** |
+
+**⇒ 명세 1장 「카탈로그에 없는 이름 271 = STmate 로 풀릴 후보」는 너무 넓음.**
+271 대부분(체인오일·예취기·농약·벌채산물)은 **임도 밖 공종**이고, 임도 안 몫도 절반은 표 읽기 문제임.
+
+---
+
+## 1. 자재 0 — 뿌리 넷
+
+| # | 뿌리 | 실측 | 풀 길 |
+| --- | --- | --- | --- |
+| 1 | **사급 자재 원천 없음** | `load_combined_catalog()` = 노임+기계+관급. `B09_Estimation_MaterialCatalog.py` 머리말 「사급 = 없다(유료 물가지 미결 No.18)」 · 관급 파일도 철근·레미콘·아스콘 **빠짐** | 사급 자재 **이름·규격·단위 목록**(`AR-M`) — 단가는 보류(명세 §2③) |
+| 2 | **품셈 칸에 규격이 없음** | 관급에 이름이 있어도(각재 8 · 철선 13 · 박리제 4 · 아스팔트 6) 품셈 칸은 「각재」 뿐 → `ResourceCatalog.resolve` 가 None | 규격은 **설계·라이브러리가 고름**. 매칭은 「규격 미정 — 후보 N」으로 드러냄(성공 아님) |
+| 3 | **자재 칸에 자재 아닌 것이 섞임** | 공구손료(버켓손료·와이어손료) · 운반비 · 연료비 · 작업 단계(단끊기·골파기·씨덮기·새채집·모래부설·유공관설치·철근가공조립) | 자원 종류 가름(경비·하위 공종) — **이름 목록으로는 안 풀림** |
+| 4 | **구조물 표는 값 없이 이름만** | 12장 측구·집수정·맨홀·날개벽 표 — 「콘크리트 \| 펌프차타설 \| ㎥ \| (빈칸)」. 숫자가 없어 머리 줄로 걸러짐(자원 0줄) | 수량은 **B08 구조물도 원단위**에서 옴 — 3장 구조물도가 이 자리를 채움 |
+
+**품셈 전체의 자재 후보 줄**(분류 딱지 「자재·재료·잡재료」 또는 자재 단위 + 숫자) — 약 90줄, 그중 값이 있고
+공종 형태가 쓸 수 있는 줄 **71줄(65종) 전부 못 맞춤 목록에 올라 있음**. 조용히 사라진 자재 줄은 없음(값 없는 머리 줄 제외).
+
+---
+
+## 2. 임도 범위로 좁힌 못 맞춘 줄 — 138줄
+
+**임도가 쓰는 코드** = 매핑표(`resources/data_work_item_mapping/…`) + B08·B09 소스에 박힌 `FP-` 60개와 그 잎.
+
+| 사유 | 줄 |
+| --- | ---: |
+| 카탈로그에 없는 이름 | 91 |
+| 뭉친 자원 줄의 이름을 못 풂 | 27 |
+| 자원은 알아봤으나 값을 못 읽음 | 12 |
+| 규격이 없어 같은 이름 여럿 중 못 고름 | 3 |
+| 값 묶음·갈래 수 안 맞음 · 장비 규격×갈래 · 작업조 표 | 5 |
+
+**맞춘 줄(임도 범위)** 244 = 노임 218 · 기계 26 · **자재 0**.
+
+### 2-1. 「카탈로그에 없는 이름」 91 의 속 — 둘로 갈림
+
+| 갈래 | 예 | 공종 | 어느 일감 |
+| --- | --- | --- | --- |
+| **진짜 자원** | 종자·비료·피복제·침식안정제·색소 | FP-05-24-01/02 | **이름·규격 목록** |
+| | 폭약·뇌관·비트·착암기·화약공 | FP-09-05-01 | 〃 |
+| | 콘크리트커트·브레이드·잡자재 | FP-09-11-01 | 〃 |
+| | 공기압축기(3.5㎥/min)·소형브레이커·어어호스(3/4인치) | FP-09-19-03 | 〃 |
+| | VR관·고무링·지수활제·기초콘크리트·거푸집 · 흄관·접합몰탈·크레인 · 파형강관·커플링밴드 | FP-12-11-01/02/03 | 〃 |
+| | 유공관설치·소운반인부 · 봉상후렉시블 다짐기·설치비 | FP-12-10 · FP-12-15 | 〃 (설치비는 경비) |
+| **표 딱지를 이름으로 읽음** | 보통암·경암·연암·풍화암 | FP-09-04-01 · 09-05-02 · 09-19-01 | **표 읽기** |
+| | 깨기 · 치즐소모량(본/hr) | FP-09-13-07~18 (12공종) | 〃 |
+| | 모래ㆍ사질토ㆍ점토… (토질 갈래) | FP-09-19-01 | 〃 |
+| | 단목·전간목·전목 | FP-04-01-01 | 〃 |
+| | 대형브레이커+유압식백호우(무한…) (조합 딱지) | FP-09-04-01 | 〃 |
+
+### 2-2. 「뭉친 줄」 27 · 「값 못 읽음」 12 — 전부 표 읽기
+
+- FP-04-02-01 100본당(흉고 구간 13줄) · FP-12-04 합판거푸집(합판·각재·철선·못·박리제) · FP-12-09-02/03 측구 · FP-13-04-04 찰쌓기
+- FP-09-13-02~18 「장비(90%) \| 유압식백호우…」 · 「들어내기 \| 유압식백호우…」 — **배분율·단계 딱지 줄의 값**을 못 읽음
+
+⚠ **FP-12-04 합판거푸집은 두 일감에 걸림** — 뭉친 줄을 풀어도(표 읽기) 합판·각재·철선·못·박리제가
+사급이라 목록이 있어야 섬(자재 0 뿌리 1·2).
+
+---
+
+## 3. 진짜 자원 약 40종 — 어디서 코드를 받을 수 있나
+
+| 이름(품셈) | 우리 카탈로그 | STmate 목록 (`name 〔size〕`) | 판단 |
+| --- | --- | --- | --- |
+| 대형브레이커 | 기계 정확 6규격 | 대형브레이커 〔0.7㎥〕 | 규격을 **옆 칸·조합에서** 받으면 섬 |
+| 소형브레이커 | 기계 「소형브레이커(공압식)/(전기식)」 | 없음 | **범위 별칭**(형식 고르기) |
+| 공기압축기(3.5㎥/min) | 기계 「공기압축기(이동식)」 | 없음 | **범위 별칭** + 규격 |
+| 크레인 | 기계 크레인(무한궤도/타이어) 45 | 크레인(타이어) 〔10톤〕 · 트럭탑재형 크레인 〔5톤·10톤〕 | 설계 고르기 |
+| 화약공 | 없음 | L 목록에 **화약취급공** | **범위 별칭** — 근거 확인 필요 |
+| 소운반인부 | 없음 | 없음 | 보통인부로 볼지 **답 필요** |
+| 종자 | 없음 | 종자 〔생태복원형,초본류 / 목본류〕 6 | `AR-M` + **규격 설계 고르기** |
+| 비료 | 없음 | 복합비료 〔21-17-17〕 · 인산질비료 | `AR-M` + 규격 |
+| 폭약 · 뇌관 | 없음 | 폭약 〔28mm(메가마이트Ⅰ)〕 · 전기뇌관 〔3.5m〕 | `AR-M` |
+| 합판 · 각재 · 철선 · 못 · 박리제 | 관급에 이름 있음(규격 여럿) | 합판(내수) 〔12×1220×2440〕 · 각재 〔외송〕 · 결속선(철선) 〔#20, 0.9mm〕 · 철못 〔N 50〕 | 관급 코드 또는 `AR-M` — **규격 고르기** |
+| 파형강관 | 없음 | 파형강관 〔Φ800·Φ1000, 2.7t〕 7 | `AR-M` + 관경은 **B08 관 정본**에서 |
+| 모래 | 없음 | 모래 〔지역별 상차가 6〕 | `AR-M` — 규격이 **지역**임 |
+| 이형철근 | 없음(관급에서 빠짐) | 이형철근 D13 · SD400 15 | `AR-M` + 규격 |
+| 치즐 | 없음 | 치즐 〔0.7m3〕 3 | `AR-M` |
+| 피복제·침식안정제·색소·착암기·콘크리트커트·브레이드·잡자재·에어호스·VR관·고무링·지수활제·흄관·접합몰탈·커플링밴드·다짐기·유공관 | 없음 | **없음** | `AR-M/X` 새로 — 이름·단위는 **품셈 원문**에서 |
+
+⇒ **STmate 가 이름·규격을 대 주는 것 13종**, 나머지 약 27종은 **품셈 원문 이름으로 `AR-` 를 새로 냄**.
+**규격은 대부분 한 벌로 안 정해짐** — 명세 §11 「(이름 + 규격) 한 쌍이 키」에 따라 품셈 칸만으로는 성공 아님.
+
+---
+
+## 4. 곁 발견
+
+- **기계 카탈로그 이름 5건에 표 머리글이 붙어 있음** — `5220-0015 소형브레이커(전기식)시 간 당(10-7)분류번호…` ·
+  `6532-0220` · `7101-0450` · `7120-0746` · `7995-0050`. 원천 `mach_base_2026.json` 파싱 흔적. 이름으로 찾으면 안 걸림
+- **품셈 원문 오기가 이름으로 들어옴** — 「어어호스」(에어호스) · 「뿜어뿥이기」(FP-05-24-01)
+- **요소·인산의 「46%·20%」** (FP-05-10 F0115) — 소요량이 아니라 **성분비**. 값으로 읽으면 틀림
+
+---
+
+## 5. 판정·답이 필요한 것
+
+| # | 물음 | 누구 |
+| --- | --- | --- |
+| 1 | 못 맞춘 줄 일감의 **범위를 임도 60코드로 좁혀도 되나** (370줄은 뒤로) | 브레인 |
+| 2 | 품셈 칸에 규격이 없는 자원 — **「규격 미정 · 후보 N」으로 드러내고 설계·라이브러리가 고르게** 두는가 | 브레인 |
+| 3 | 범위 별칭 후보 — 화약공→화약취급공 · 소형브레이커→(공압식) · 공기압축기→(이동식) · 소운반인부→보통인부 | **사용자 확인** (도메인 판단) |
+| 4 | 사급 자재 `AR-M` 목록의 자리 — 새 폴더 한 벌(이름·규격·단위·출처·STmate 코드) | 브레인 |