Merge remote-tracking branches 'origin/main_desktop_1' and 'origin/sub_desktop_1' into main_laptop_1

2026-09-22 10:33:35 +09:00
parent 7bb11a5bf0 2dcaba08ba
commit 3e89bf4987
1 changed files with 62 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 공종이란 — 무슨 자료이고 화면 어디에 보이나 (2026-09-22)
+
+읽기 전용 분석 — 코드·데이터 하나도 안 고침. 프로그래머 아닌 사용자를 위한 쉬운 설명.
+
+## 한 줄 요약
+
+공종 = **품셈 책의 절 번호**(예: "9-3-1. 인력") — 무슨 일을 하는 항목인지 나누는 목차. 그 절에 표(단가·소요량 표)가 몇 개 딸리는지, 그 절이 안 바뀌는 고유 번호(열쇠)로 무엇인지, 산림과 건설의 같은 항목끼리 이어져 있는지, 그 절에 인력·재료·기계가 얼마나 들어가는지(자원) — 이 다섯 가지를 한 벌로 묶어 놓은 것이 「공종 마스터」.
+
+## ① 파일 한 줄을 통째로 봄
+
+산림 공종 마스터(`resources/master_data/old/2_공종_산림_마스터_2026-01-01.json`)에서 실제 항목 하나:
+
+> 나무베기 › 단목베기 › 1,000㎡당 — 갈래: 5m 미만 / 5m이상~8m미만 / 8m 이상
+
+이 한 줄이 담은 칸들:
+
+| 칸 | 뜻 | 이 항목의 값 |
+|---|---|---|
+| 목차 코드 | 품셈 책의 절 번호(개정판마다 밀릴 수 있음) | `FP-04-02-02` |
+| 이름 | 소속 장까지 붙인 전체 경로("소속 장 › 중간 마디 › 이 항목 이름") | `나무베기 › 단목베기 › 1,000㎡당` |
+| 불변 열쇠 | 개정판이 바뀌어도 안 변하는 이 항목만의 고유 번호 | `FW-00097`(산림 접두 FW, 건설은 CW) |
+| 갈래(규격) | 같은 절 안에서 나무 높이·굵기 따위로 나뉜 세부 조건 | `5m 미만` · `5m이상~8m미만` · `8m 이상` |
+| 딸린 표 | 이 절에 실제 단가·소요량 표가 몇 장 붙는지(표 번호) | 표 1장(`F0087`) |
+
+**소속 장** — 위 "이름" 칸의 맨 앞 조각("나무베기")이 그 항목이 속한 장(챕터). 장 → 절 → 항목 순서로 내려가는 계층.
+
+**열쇠대장**(`2_공종_산림_열쇠대장.json`·`2_공종_건설_열쇠대장.json`) — 위 표와 별도 파일. "이번 개정판의 목차 코드 → 불변 열쇠" 짝을 판마다 적어 두는 장부. 다음 개정으로 목차 번호가 밀려도 이 장부를 보면 같은 항목임을 알 수 있음(산림 477개 · 건설 1,367개 짝).
+
+**연결**(`2_공종_산림건설_연결_2026-01-01.json`) — 산림 공종과 건설 공종 중 "같은 일"인 것끼리 이어 놓은 표(78쌍). 예: 산림의 돌쌓기 항목과 건설의 돌쌓기 항목이 실은 같은 시공법이면 여기서 이어짐 — 산림 쪽 값이 없을 때만 건설 쪽으로 보충.
+
+**자원줄**(`2_공종_산림_자원줄_2026-01-01.json`) — "이 항목(표)에 인력·재료·기계가 무엇이 얼마나 들어가는가" 를 적은 별도 파일(418줄). 예: 위 F0087 표(나무베기 1,000㎡당·5m 미만)에는 "벌목부 2.14 인" · "보통인부 0.51 인" 이 자원줄에 적혀 있음 — 공종 마스터 자체에는 이 숫자가 없고, 자원줄이 표 번호(`F0087`)로 연결해 붙여 줌.
+
+**줄 수** — 건설 마스터 196,058줄(목차마디 1,367 · 딸린 표 2,279장) · 산림 마스터 44,661줄(목차마디 477 · 딸린 표 475장).
+
+## ② 화면 어디에 보이나
+
+| 화면 | 자리 | 무엇이 뜨나 | 근거 |
+|---|---|---|---|
+| **Z01 기초단가**(`z01-master-data`) | 왼쪽 목록 "산림품셈 기준"·"건설품셈 기준" 상자 | 위 표의 목차 코드·전체 경로 이름·갈래·딸린 표 번호·연결 여부 | `Z01_MasterData_WorkItems.py` `base_rows()`(59~127행)가 이 칸들을 그대로 만듦 · 상자 이름은 `old/4_화면_이름표_2026-01-01.json`의 `name_ko`("산림품셈 기준"/"건설품셈 기준") |
+| **B08 수량산출** | 토공집계표 · 구조물 수량 산출 표의 「공종」 열 | 그 물량 줄이 어느 공종인지(목차 코드·이름) | `B08_Quantity_UI_SummaryGrid.ts` 5행("토공집계표 열은 … 구분·공종·규격 …") · `B08_Quantity_UI_StructureSheet.ts` 291행 열 이름 목록에 `"공종"` |
+| **B09 견적** | 내역서(예산내역서) 탭의 첫 열 「공종」 | B08 이 넘긴 목차 코드로 자동 매긴 항목 번호·이름 | `B09_Estimation_UI_Tab_Bill.ts` 5행("열은 실무 설계내역서 그대로: 공종 · 명칭 …") · `B09_Estimation_BillOfQuantities.py` 가 `work_item_code` 로 항목을 트리에 얹고 번호를 매김(공종 코드가 없으면 "공종을 못 골랐습니다" 로 막음) |
+
+⚠ 이번엔 로그인 세션이 풀려 있어 화면을 직접 열어 글자까지 눈으로 확인하지 못함 — 위 세 자리는 전부 코드가 그 값을 화면에 넣는 자리를 근거로 확인한 것. 실제 화면 글자 확인은 다음에 로그인된 창에서 마저 할 것.
+
+## ③ 단가산출 로직·소요량·계수와 다른 점
+
+공종 마스터는 **"무슨 항목인가"** 를 정하는 목차 축이고, 로직·소요량·계수는 **"그 항목값을 얼마로 계산하나"** 를 정하는 자원 축 — 서로 다른 일을 함.
+
+- 공종 마스터: 품셈 절 번호 계층 + 표 소속 + 안 바뀌는 열쇠. 열쇠 꼴이 `FW-00097`처럼 다섯 자리 번호.
+- 로직·소요량·계수: 그 표 한 장 안에서 인력·재료·기계를 무엇으로 얼마나 쓰는지의 계산 방법. 열쇠 꼴이 `GF0087`·`GC000994`처럼 전혀 다른 번호 체계.
+
+하나가 없어지면 다른 하나가 대신할 수 없음 — 공종 마스터가 없으면 "이 물량이 어느 항목인지" 이름을 못 붙이고(B08→B09 로 물량을 넘길 때 실제로 이 번호로 서로를 찾음), 로직·소요량·계수가 없으면 이름은 있는데 "돈이 얼마인지" 를 못 셈함. 코드 안에도 "공종 축만 만든다. 자원 축은 B09 가 따로 채운다" 라고 이 경계가 못박혀 있음(`B08_Quantity_Build_WorkItemMaster.py`).
+
+## ④ 구조가 바뀐 이력
+
+| 날짜 | 무엇이 바뀌었나 |
+|---|---|
+| 2026-09-07 | 산림 공종 마스터 첫 생성(476개 표 → 공종 축 정리) · 같은 날 자원줄 파일도 처음 따로 분리해 냄 |
+| 2026-09-08 | 자원줄 한 번 다시 만듦 · 공종 마스터도 한 번 다시 만듦(오류 보완) |
+| 2026-09-17 | 목차 코드가 곧 열쇠이던 방식을 버리고, 안 바뀌는 열쇠(FW-/CW-)를 새로 붙임 — 같은 날 건설 공종 마스터도 처음 생김(그 전엔 산림만 있었음) |
+
+앞으로 계획 — `resources/master_data/ref/_걷을_옛코드.md` 문서에 이미 적혀 있음: 지금 `old/` 자리는 임시 자리이고, 나중에 화면 이름표·기계값과 함께 "새 마스터"로 옮길 계획이 잡혀 있음(아직 실행 전 · 실행되면 `old/`·`ref/` 를 지우는 것이 마지막 단계).