chore(ledger): 설계 857 — 걸음 4 불러오기 한 번 읽기(두 계보 대조 · 재료 규칙 차이 · 문서 바로 · 걸음 857-0 ~ 5)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,277 @@
|
||||
# 설계 857 — 걸음 4 「불러오기 한 번 읽기」 (요구 896 · PLAN 857)
|
||||
|
||||
sub8 · 2026-11-17 · 읽기 · 세기만(코드 · 자료 · 시험 고침 0). 바탕 = `_분석_894-C_불러오기.md`(「분석 C」) · `설계_855_정본하나_계산기하나.md`(「본 설계」) · `설계_855_보충_B09_로직JSON_호환.md`(「보충」) · `_방향_불러오기.md` 0 절.
|
||||
세는 도구 · 결과 = `tmp/s894/m857/`(끝 표). 견본 = 저장소의 실무 엑셀 11(`test_797_1a_import_flags.FILES`) · 경쟁사 자료 내용 · 푸는 법은 안 옮김(모듈 구실만).
|
||||
|
||||
## 0. 한눈 요약
|
||||
|
||||
- **두 계보가 읽은 블록은 이미 같음** — 엑셀 11 에서 단가산출 블록 번 · 단위 · 블록 금액이 두 계보 모두 같음(다름 1 = 빈 블록 「{}」 대 「0」). 이름만 꼴이 다름(EST 호표 쪽 = 「이름(규격)」 한 칸 · 둘 꼴 = 이름 · 규격 두 칸 / STmate 둘 꼴 = 「이름 규격 / 단위」 머리 글). → **호표 계보를 둘 꼴 위에 얹는 것은 가능**. 다만 호표 쪽이 더 읽는 것(항목 · 절 · 출처 · 직종 · 줄합 · 덮음 · **EST 일위대가 시트 전체**)을 둘 꼴에 더 실어야 함(1-3).
|
||||
- **엑셀 11 중 2 개(516 블록)는 지금 화면에서 못 올림** — 일위대가 시트가 없으면 호표 읽기가 400 을 내고 산근 읽기까지 안 감(`M02_Hopyo_Router.py:83`). 산근 계보는 이 둘을 읽음(374 · 142 블록 · 「3,241 블록 재현」 에 들어 있음). 한 번 읽기(산근 계보 먼저)가 이것도 풂.
|
||||
- **올림 한 번 = 책 열기 2 회 + 격자 XML 1 회**(`_open` 1 · `San_Book.sheets` 1 · 격자는 `opened` 재사용) — 큰 xlsx(거창)는 두 번째 열기만 9.3 초. 한 번 열기로 그만큼 줄어듦.
|
||||
- **재료 이음 규칙을 호표 길에 그대로 쓰면 118 줄이 바뀜**(9 파일 · 자재 · 별도계상 393 줄 중) — 생김 106 · 다른 품목으로 바뀜 12 · 풀림 0 · 그중 **109 줄 금액이 엑셀과 달라짐**. 차이의 거의 전부는 「규칙」 이 아니라 **호표 길의 「단가가 엑셀과 같을 때만 이음」 관문**(`M02_Hopyo_Fixed.py:153`)에서 옴(생김 중 정확 일치 66 · 표기 32 · 규칙 F2 8). 고정 줄은 이으면 우리 단가로 셈 → 「엑셀 숫자 그대로」 와 정면으로 부딪힘(2 절 · 판단 거리 1).
|
||||
- **「고를 재료」 판 첫 셈이 느린 까닭은 변환이 아니라 M01 「바뀌었나」 확인** — 블록마다 줄마다 `m01.loaded()` 가 M01 파일 날짜를 다시 잼(65 블록에 2,069 번 · 시간의 약 80 %) + 기계 파일 목록 glob 2,069 번. 실측 4 ~ 41 초/파일(북부청임도 95 블록 40.9 초). 셈 한 번 동안 M01 한 벌을 쥐면 결과 그대로 몇 초로 줄 것(5 절) — 「재료 줄만 도는 길」 보다 작고 안전.
|
||||
- **가져온 식은 「옛 로직 줄 꼴 → 옛 엔진 → 빌더 변환기」 를 거쳐 문서가 됨**(`M02_Doc_Import.py:409-422` · `master_doc_convert.convert`). 2-C2 가 옛 엔진만 걷음 · **변환기(`master_doc_convert`)는 그대로 남음** → 본 설계 2-E3(빌더 · 변환기 은퇴) 앞에 857 의 「읽기기가 문서를 바로 냄」 이 끝나야 함(차례 조건 · 3 절).
|
||||
- **L2 ⓒ(불러오기가 M01 로직 줄을 읽는 곳)는 실제로 9 곳 7 파일**(보충 2-2 의 「관문」 줄 대부분은 M01 요소 색인 `m01.loaded()` 로 로직 줄이 아님 · 4 절) — 857 걸음 안에 합침 권함.
|
||||
- 걸음 = **여섯**(857-0 지킴 · 857-1 책 한 번 · 857-2 호표를 둘 꼴 위로 · 857-3 문서 바로 · 857-4 재료 한 벌 · 857-5 옛 길 지움) · 병행 묶음 셋 · 앞 조건 = 본 설계 2-C2 · 2-C3 · 2-C5(`Hopyo_Build._inside`) 끝(6 절).
|
||||
|
||||
---
|
||||
|
||||
## 1. 읽기 한 번
|
||||
|
||||
### 1-1 지금 올림 한 번(엑셀)
|
||||
|
||||
| 차례 | 자리 | 하는 일 | 책 열기 |
|
||||
| --- | --- | --- | --- |
|
||||
| ① | `M02_Hopyo_Router.py:83` → `M02_Hopyo_Excel.read_book:300` → `_open:112` | 일위대가 · 총괄표 · 단가산출 · 목록 시트(STmate = `Hopyo_Stmate.SHEETS`) 줄 · **일위대가 시트 없으면 400** | xlsx `openpyxl` 1 · xls `xlrd`(서식) 1 |
|
||||
| ② | `Router.py:87` → `Hopyo_Grid.read:325` → `Hopyo_Excel.opened:102` | 격자(보기) — ① 책 재사용(`_OPENED:58` 프로세스 전역 하나) · xlsx 는 ZIP XML 을 따로 읽음(`Grid.py:212`) | 0(+ XML) |
|
||||
| ③ | `Router.py:91` → `Sangeun_FromHopyo.keep:50` → `San_Book.sheets:40` | 산근 시트(STmate 8 · EST 7) 줄 — **책을 처음부터 다시 엶** | 1 |
|
||||
| ④ | `FromHopyo._excel:73` → `San_Xlsx.read_sheets` → `Doc_FromNative.pack` | 둘 꼴 → `실무자료/산근/<HP>.json` `{파일 시트 엑셀}` | 0 |
|
||||
|
||||
종류 가름 두 곳 · 시트 목록 둘:
|
||||
|
||||
| | 호표 쪽 | 산근 쪽 | 갈림 |
|
||||
| --- | --- | --- | --- |
|
||||
| 종류 가름 | `Hopyo_Stmate.is_stmate:67` = 「일위대가표」 **와** 「단가산출근거」 | `San_Book.kind_of:67` = 「단가산출근거」 있으면 STmate · 「단가산출」 있으면 EST | 단가산출근거만 있는 STmate = 호표 쪽 EST 로 보고 「일위대가 시트 없음」 400 · 견본 11 에서는 셋 다 같은 판정 |
|
||||
| 시트 목록 | `Hopyo_Excel` SHEET · SUMMARY · `ReadEst.SHEET` + LISTS · `Hopyo_Stmate.SHEETS`(7) · `Grid.EXTRA` | `San_Book.STM_SHEETS`(8 · 중기사용료 · 일위대가표 더 있음) · `EST_SHEETS`(7 · 기계경비 · 자재 · 노임 · 견적단가 더 있음) | 두 목록 합집합이 한 번에 읽을 시트 |
|
||||
|
||||
### 1-2 세기 — 두 계보가 읽은 단가산출 블록(`m857_read.py` → `out_read.json`)
|
||||
|
||||
| 파일 | 꼴 | 호표 쪽 단산 | 둘 꼴 산근 | 같은 번 | 단위 다름 | 금액 다름 | 이름 꼴 다름 | 호표 읽기 초 | 산근 책 다시 열기 초 |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| 북부청임도 | EST xls | 95 | 95 | 95 | 0 | 1(빈 블록) | 87 | 3.7 | 0.08 |
|
||||
| 북부청사방 | EST xls | 67 | 67 | 67 | 0 | 0 | 47 | 1.9 | 0.10 |
|
||||
| 거창 | EST xlsx | 61 | 61 | 61 | 0 | 0 | 47 | 10.4 | **9.28** |
|
||||
| 봉화 · 영월 · 울진대흥 · 영덕 · 울진소광 · 대흥공통 | STmate xlsx | 282 | 282 | 282 | 0 | 0 | 282 | 12.4 | 3.29 |
|
||||
| 2016사방 · 2026수목 | EST xls | **0(400)** | 516 | — | — | — | — | — | 0.13 |
|
||||
| 합 | | 505 | 1,021 | 505 | 0 | 1 | 463 | 28.5 | 12.9 |
|
||||
|
||||
- 「이름 꼴 다름」 = 같은 블록 · 쓰는 법만 다름(1 절 요약) — 둘 꼴에 「보일 이름」 하나를 더 실으면 됨.
|
||||
- 「산근 책 다시 열기」 = 한 번 읽기로 없어지는 시간(거창 꼴 큰 xlsx 에서 큼).
|
||||
|
||||
### 1-3 호표 계보가 둘 꼴 위에서 돌려면 더 실어야 할 것(호표 쪽 단산 칸 전수 · 505 블록)
|
||||
|
||||
| 호표 쪽 칸(`Hopyo_Excel.read_book:369` keep) | 만드는 곳 | 읽는 곳(호표 계보 · 그 밖) | 둘 꼴에 지금 | 더 실을 것 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 번 · 이름 · 단위 · 행 | ReadEst · Stmate | 목록 · 칠 · 격자 | 번 · 이름(+ 규격) · 단위 · 엑셀행 | 「보일 이름」(호표 쪽 꼴) |
|
||||
| 금액 {계 노무비 재료비 경비} | 같음 | 검산 · 목록 | 저장 {T L M S} | 없음(이름만 바꿔 읽음) |
|
||||
| 글 · 글행 | ReadEst(EST) | 근거 보기 · 칠 · `Hopyo_Formula` | EST 줄 `행` · `보임`(같은 시트 줄) / STmate 줄 `글`(숨은 G 열) | STmate = 보이는 글(B 열) 줄 · 아니면 그대로 |
|
||||
| 출처 [[책, 절]] | `Hopyo_Clause.settle` | 근거 표 · `San_Basis_Index` | 없음 | 글에서 셈(지금 부품 그대로 · 둘 꼴 위로 옮김) |
|
||||
| 직종 | `ReadEst.trade` | 근거 · `San_Basis_Index:122` | 없음 | 같음 |
|
||||
| 항목 [{묶음 이름 규격 품 밑품 율 인자 어떻게 단가 금액 절 윗절 절율 행 재현 기준* 계수 손료율 …}] | `ReadEst.items:298` · `Hopyo_Formula` · `Hopyo_Stmate._blocks` | `Hopyo_Marks`(칠 · 줄 표지) · `Hopyo_Units` · `Hopyo_UnitLine`(재현 · 덮음) | EST 구조 줄(자원 · 결과 · 변수 · 연결단가 · 비목 · 품명) · STmate 원문 풀이 | **품 · 율 · 인자 · 절 나무(`Formula`)** — 구조 줄로는 못 냄 · 그 계산은 남기고 입력만 둘 꼴 줄로 |
|
||||
| 절 [{번 층 제목 갈래 행 글 상수 식}](EST) | `Hopyo_Formula` | 칠 · 근거 | 없음 | 위와 같음 |
|
||||
| 줄합 · 덮음 | `Hopyo_UnitLine.settle` | 호표 줄 투영 · 칠 | EST 없음 · STmate `줄합`(산근 쪽은 `pack` 이 버림 · 분석 C 2-1) | `줄합` 버리지 않음 |
|
||||
| 코드 · 규격 · 자원(STmate) | `Hopyo_Stmate` | 목록 · 이음 | 코드 · 규격 · 줄 글 | 자원 줄 메타(M · H · X 열) |
|
||||
| **EST 일위대가 시트(호표 · 줄 · 참조 · 갈래 · 검산)** | `Hopyo_Excel.read_book:300-360` | 호표 목록 · SC 만들기 · **B09 내역서 불러오기**(`B09_Estimation_Bill_Hopyo.py:41`) | **없음**(`San_Xlsx_Est` 일위 = 빈 목록 · STmate 는 `San_Xlsx_Ilwi` 로 있음) | EST 일위 읽기(지금 함수 그대로)를 둘 꼴 `일위` 로 |
|
||||
| 일위대가총괄표 · 목록 시트 줄 | `_summary` · 격자 | 검산 · 격자 | 없음 | 시트 줄(한 번 읽은 책에서) |
|
||||
|
||||
못 얹는 것(그대로 둠):
|
||||
- **격자**(`Hopyo_Grid`) — 서식 · 병합 · 열 폭 = 책 자체(xls 서식 · xlsx XML)가 필요 · 둘 꼴과 무관. 한 번 연 책을 넘겨받는 꼴만.
|
||||
- **붙여넣기**(`Hopyo_Paste.read_text`) · **B09 내역서**(`Bill_Excel` · `Import_Prices` · `Import_Rates` 가 `hx._text` · `_flat` · `_out` · `DRM` 씀) — 엑셀 책이 아닌 입구 · 작은 도우미만 공유 → 도우미를 공용 자리에 두고 그대로.
|
||||
- 호표 쪽 **항목 계산 몸**(`ReadEst.items` 116 줄 · `Formula` 352 줄) — 읽는 것은 같은 시트 글이므로 「입력 = 둘 꼴 줄」 로만 바꾸고 몸은 둠(지우면 칠 · 줄 표지 · 고정 줄 회귀가 큼).
|
||||
|
||||
### 1-4 끝 모습
|
||||
|
||||
- 책 열기 = **한 곳**(새 「책 한 벌」 · 시트 목록 합집합 · 종류 가름 한 말 · xls 서식 책 함께) → ① 둘 꼴(`pack` · 일위 포함) ② 격자 ③ 호표 목록이 그 위.
|
||||
- 올림 순서 = **산근(둘 꼴) 먼저** → 일위대가 시트 없으면 호표 목록만 빔(400 아님) · 둘 꼴 못 읽으면 지금처럼 「읽기불가」 사유.
|
||||
- `_OPENED` 전역 걷음(책 한 벌을 인자로 넘김).
|
||||
|
||||
---
|
||||
|
||||
## 2. 재료 이음 규칙 한 벌
|
||||
|
||||
### 2-1 두 길 차이 전수
|
||||
|
||||
| 항목 | 단가산출 길 `San_Link.m01:15` → `San_MatFind.find:125` | 호표 길 `Hopyo_Fixed.Linker.link:107` · `_mats:159` |
|
||||
| --- | --- | --- |
|
||||
| 밑 부품 | `Hopyo_Match` · `Hopyo_Material` · `Hopyo_MatSame` · `Elem_Alias` | 같음(`hm._exact` · `hmat.sure`) |
|
||||
| 코드 길 | EST 원파일 자원 코드 → 우리 자재 출처 코드(`ea.est_code` · 815-1 K1) | 없음 |
|
||||
| 별칭 | 있음(`ea.keys`) | `hm._exact` 안의 별칭만 |
|
||||
| 표기 다름(817-1) | 있음(`_how` 「표기」) | 없음 |
|
||||
| 자동 규칙 A ~ F2 | 있음(`RULES:346`) | 없음 |
|
||||
| 단서(산근 줄 글 · 머리 · 내역서 · 일위대가표) | 있음(`clues_on:91`) | 없음 |
|
||||
| 단위 맞춤 | 쌍둥이 › 같은 성격 › 고르기(`_by_unit:176`) | 단위 배 = 1 일 때만 |
|
||||
| **단가 값** | **안 봄**(판정 = 글만 · 두 판 [엑셀 단가로] · [우리 단가로]) | **엑셀 재료비 단가와 1 원 안으로 같은 품목 하나일 때만**(`_same:152`) |
|
||||
| 유가 · 환율 | 재료 줄이 MO · 화폐 이름이면 유가 · 환율로 | 없음(자재만) |
|
||||
| 별도계상 | 품목 찾되 이음 비움(단가 0 그대로) | 재료비 있으면 같은 관문 |
|
||||
| 못 이은 줄 | 판정 다섯 갈래 + 후보 → 사람 고름(`San_MatPick`) | 후보 수만(`near`) → [수정] 모달 고름 |
|
||||
| 이은 뒤 셈 | 가져온 식 = 두 판(엑셀 값 기억 · `Doc_Import` `엑셀` 칸) | **고정 줄 = 이은 비목은 우리 단가 책 값**(`M02_Labor_Fixed.py:6-9`) · 엑셀 값 기억 없음 |
|
||||
|
||||
### 2-2 세기 — 호표 길이 단가산출 규칙을 쓰면(`m857_mat.py` → `out_mat.json` · `out_mat.tsv`)
|
||||
|
||||
대상 = 일위대가 시트 호표 줄 중 자재 · 별도계상 갈래(9 파일 · 393 줄 · 단서 = 같은 파일 둘 꼴 단서).
|
||||
|
||||
| 파일 | 같음(이음) | 같음(못 이음) | 생김 | 다른 품목 | 풀림 | 금액 달라짐 | 엑셀 값 그대로 |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| 북부청임도 | 1 | 97 | 32 | 12 | 0 | 44 | 0 |
|
||||
| 북부청사방 | 0 | 48 | 8 | 0 | 0 | 5 | 3 |
|
||||
| 거창 | 1 | 10 | 5 | 0 | 0 | 5 | 0 |
|
||||
| 봉화 | 8 | 13 | 19 | 0 | 0 | 17 | 2 |
|
||||
| 동부청영월 | 0 | 36 | 5 | 0 | 0 | 3 | 2 |
|
||||
| 울진대흥 · 대흥공통 | 0 | 36 | 26 | 0 | 0 | 24 | 2 |
|
||||
| 영덕계류 | 4 | 0 | 0 | 0 | 0 | 0 | 0 |
|
||||
| 울진소광 | 0 | 13 | 11 | 0 | 0 | 11 | 0 |
|
||||
| **합** | **14** | **253** | **106** | **12** | **0** | **109** | **9** |
|
||||
|
||||
- 생김 106 의 방법 = 정확 일치 66 · 표기 32 · 규칙 F2 8 → **새 규칙보다 「단가 같을 때만」 관문이 차이의 대부분**.
|
||||
- 다른 품목 12(북부청임도 돌망태 둘 × 6) = 호표 길은 단가가 엑셀과 같은 품목(지역 · 판이 맞는 줄)을 고름 · 단가산출 길은 단가를 안 보고 표기로 다른 품목을 고름 → **규칙 한 벌로 가면 이 12 줄은 품목이 틀어짐**(호표 길 쪽이 맞음).
|
||||
- 「금액 달라짐」 = 이은 품목의 우리 단가 ≠ 엑셀 재료비 단가(고정 줄은 이으면 우리 단가로 셈).
|
||||
|
||||
### 2-3 「엑셀 숫자 그대로」 와 부딪히는 자리
|
||||
|
||||
| 자리 | 부딪힘 | 피하는 법(안) |
|
||||
| --- | --- | --- |
|
||||
| 고정 줄 이음 = 우리 단가로 셈(`Labor_Fixed.py:6-9`) | 이음이 늘면 SC 금액이 엑셀과 달라짐(109 줄) | ㉠ **규칙 한 벌 = 「찾기」 만**(키 · 후보 · 판정) · 호표 길은 「단가 같음」 관문을 그대로 두고 단가 다른 짝은 「후보 · 판정」 으로만 보임(권함) ㉡ 고정 줄에도 엑셀 값 기억(두 판)을 둠(SC 꼴 바뀜 · 큼) ㉢ 이음 늘림을 받아들이고 금액이 우리 단가로 바뀌는 것을 인정 |
|
||||
| 다른 품목 12 | 단가산출 길은 단가를 안 봐 지역 · 판이 다른 품목을 고름 | ㉠ 에서는 호표 길이 「단가 같은 후보」 를 먼저 고름 = 지금 결과 그대로 · 단가산출 길에도 같은 「값 같은 쌍둥이 먼저」 를 더할지는 판단 거리 2 |
|
||||
| 705-3 「빠짐 0」 | 이음 판정이 바뀌어도 줄이 빠지지 않음(고정 줄 그대로) | 지킴 시험 그대로 |
|
||||
|
||||
→ 권함 = **「찾기 한 벌 · 관문은 길마다」**: 호표 길 `_mats` 를 `San_MatFind.find`(단서 포함) 후보로 바꾸되 「엑셀 단가와 같은 후보 하나」 일 때만 이음 · 나머지는 판정 · 후보로 [수정] 모달에 보임. 이러면 금액 달라짐 0 · 생김 = 지금 관문을 통과하는 것만 · 다른 품목 0 · 화면의 「후보 · 판정」 말이 두 길에서 같아짐.
|
||||
|
||||
---
|
||||
|
||||
## 3. 가져온 식을 문서로 바로
|
||||
|
||||
### 3-1 지금 길(블록 하나 → 저장 SK)
|
||||
|
||||
| 단 | 꼴 | 자리 | 옛 식 파서 · 엔진 · 변환기 |
|
||||
| --- | --- | --- | --- |
|
||||
| ㉠ 둘 꼴 | 블록 구조 줄 | `Doc_FromNative.pack:49` | — |
|
||||
| ㉡ 옛 로직 줄 `{로직 {이름 결과단위 입력 중간 호표 덧줄 단계 끝전 조정 끝수}, 원본}` | `Doc_NativeEst.block:610`(EST) · `San_Emit.stmate`(STmate) · 이음 · 재료 · 기계 판정 얹음 | `San_Expr` · `San_Stmate.parse_line`(경쟁사 글 풀이 · 남음) |
|
||||
| ㉢ 가져온 식 SK `가져온 {로직 원본 검산 단가기준}` | `Sangeun_Imported.new_doc:569` · `check:368` → `_run:346`(옛 엔진) | 옛 엔진(2-C3 이 걷음) · `whole.logic`(:179) |
|
||||
| ㉣ 수식 문서 | `Doc_Import.derive:409` = `_ctx:74`(옛 엔진 · **2-C2 가 걷음**) → `master.logic(key)` → **`master_doc_convert.convert`**(:422) → `_attach` · `_numbers` · `_native` · `Shape` · `Q` · `NativeLayout` | 변환기 · `mf.parse` · `mf._OPS` · `_plain`(`_swap_nth` · `_picks` · `_logic_link`) |
|
||||
|
||||
옛 로직 줄 꼴(㉡ · ㉢)을 읽고 쓰는 자리(불러오기 안 · `out_l2.tsv` 의 「로직」 칸 줄): `Sangeun_Imported`(:7 · 109 · 127 · 281-319 · 334 · 374 · 513-518 · 578) · `Doc_Import`(:142 · 249 · 419) · `Doc_Import_Shape:259` · `Doc_NativeLayout:42 · 68-70` · `San_MatPick:206 · 342` · `San_MyMachine:368-391` · `Sangeun_FromHopyo:133-244` · `Sangeun_QtyLinks:241 · 290 · 330` · `Doc_FromNative:145` · `San_Emit` · `Doc_NativeEst` — **15 파일**.
|
||||
|
||||
### 3-2 바꾸는 길 — 읽기기가 문서를 바로 냄
|
||||
|
||||
| 박자 | 무엇 | 걷히는 것 |
|
||||
| --- | --- | --- |
|
||||
| 첫 박자(857-3a) | ㉡ 꼴은 그대로 두고 **㉡ → 문서 변환을 불러오기 자기 모듈로**(새 `M02_San_ToDoc`) — 지금 `derive` 가 하는 일(변환기 몫 + 붙임 · 다듬기)을 옛 로직 줄 대신 ㉡ 를 직접 읽어 문서 변수 · 식 · 금액 줄로 · 식 글 파서 = 문서 파서(`master_doc.parse`) 또는 `San_Expr` | `Doc_Import` 의 `master_doc_convert` 부름 · `master.logic` · `_Row`(가짜 마스터) · `mf.parse` · `_OPS` · `_plain` |
|
||||
| 둘째 박자(857-3b) | **SK 정본 = 문서**(`수식`) · `가져온` = `{원본 · 단가기준 · 검산}` 만(호환 안 만듦 · 요구 899) · 이음 고침 · 두 판 · 소요량 고름 · 재료 고름 · 내 기계가 문서 연결을 고침 · 다시 열기 = 저장 문서 그대로(`derive` 없음) | `가져온.로직` · `Sangeun_Imported` 의 옛 줄 꼴 정리(`clean_row` · `row_of` · `_with`) · `San_Basis_Index` · `Sangeun_QtyLinks` 의 옛 식 파서 부름(`mf.parse` · `_OPS` 5 + 3 곳) · `Doc_Import_Reset` 의 옛 줄 되돌림(초기화 = 원본에서 다시 지음) |
|
||||
| 끝 | 2-E4 「바탕 기반」 새 모듈에서 **옛 식 파서도 뺌**(보충 3-3 의 「857 이 문서를 바로 내면 그때 파서도 걷음」) | `mf.parse` 류(불러오기 몫 0) |
|
||||
|
||||
- 읽기기(㉠ · `San_Xlsx*` · `San_Estx` · `San_Stc`)와 `San_Expr` · `San_Stmate.parse_line`(경쟁사 글 풀이)은 그대로 — 바뀌는 것은 ㉡ 뒤.
|
||||
- **차례 조건**: 본 설계 2-E3 이 `master_doc_convert` 를 은퇴시키므로 **857-3a 가 2-E3 앞**에 끝나야 함(아니면 2-E3 이 불러오기용으로 변환기를 남겨야 함).
|
||||
|
||||
### 3-3 3,241 블록 금액 재현 지키는 법
|
||||
|
||||
| 지킴 | 지금 | 857 에서 |
|
||||
| --- | --- | --- |
|
||||
| 블록 금액(계 · 비목) | 저장소 시험 = `test_812_1` ③(엑셀 11 = 1,021 블록 · 문서 셈 = 엑셀 금액) · `test_810_2`(원파일) · 전수 3,241 = sub7 `tmp/s894/m855b/m855_import.py`(저장소 밖 · 옛 = 새 대조) | **857-0 에서 저장소 지킴 시험으로 올림** — 3,241 블록 × 두 판(엑셀 · 우리) 계 · 비목 지문(`golden_857_import.json`) + 검산 판정 지문 · 원파일 견본 없으면 건너뜀 |
|
||||
| 줄 꼴 | 없음 | 블록마다 문서 금액 줄 수 · 이름 · 비목 지문(857-3 전후 같음 · 줄 쌓기 화면이 같은 줄을 봄) |
|
||||
| 이음률 | `_방향_불러오기.md` 0 절 수(인력 100 · 기계 90.8 · 재료 72.0 %) | 지킴 시험 안에 갈래별 이음 수 · 판정 수 지문(857-4 는 「뜻한 바뀜」 표로 다시 뜸) |
|
||||
|
||||
---
|
||||
|
||||
## 4. L2 ⓒ — 불러오기가 M01 로직 줄을 읽는 자리(`m857_l2.py` → `out_l2.tsv`)
|
||||
|
||||
보충 2-2 의 「불러오기 이음」 줄(Hopyo_Elem 5 · Match 3 · Clause · Relink · Row · Units · Build · Doc_Import · San_*)을 코드 줄로 펼친 결과 — **대부분은 M01 요소 색인(`m01.loaded()[1]` · LB · MT · EQ · MO · FX)이라 로직 JSON 이 아님**. 로직 줄(로직 JSON)을 실제로 읽는 곳만:
|
||||
|
||||
| 자리 | 읽는 것 | 갈 곳(수식 문서 읽기) | 걸음 |
|
||||
| --- | --- | --- | --- |
|
||||
| `M02_San_Basis_Index.py:160` | `로직_*.json` 파일을 **이름으로** glob | 수식 문서 파일(`수식_*.json` · `master_doc_link.load_all`) | 857-3b(옛 식 파서와 같이) |
|
||||
| `M02_Hopyo_Clause.py:68-71` | M01 파일 중 그룹 「로직」 의 구분 · 원문번호(출처 → 기초 짝) | 문서 머리 원문번호(보충 L1 이 싣는 이름표) | 857-2 |
|
||||
| `M02_Hopyo_Match.py:211-221` | 로직 줄 키 · 이름 + 알약 단위(`combo_pills`) — 맞춤 대상 | 문서 머리 이름 · 결과단위 | 857-2 |
|
||||
| `M02_Hopyo_Units.py:72` · `:209` | `whole.logic(code).입력` · 기계 로직 | 문서 변수(입력 갈래) | 857-2 |
|
||||
| `M02_Doc_Import.py:415` · `:488` | 옛 엔진 색인의 로직 줄 · 하위 로직 | 없앰(857-3a) | 2-C2 가 반 · 857-3a 끝 |
|
||||
| `M02_Sangeun_Imported.py:179` | 「로직(GC…)」 부름 키 있나 | 문서 있나(`Links.doc`) | 2-C3 |
|
||||
| `M02_Sangeun_Imported.py:419` | `over.logic(key)` 자동값(`mau`) | 문서 변수 기본값 | 2-C5(`_inner`) |
|
||||
| `M02_Hopyo_Build.py:332-333` | `run_line` 로 하위 로직 금액 | 문서 셈 | 2-C5(`_inside`) |
|
||||
| `M02_Hopyo_Relink.py:119` · `Hopyo_Compare.py:55` | `Labor_Ref.Expand`(일위대가 참조 펼침 — 안에서 로직 줄을 읽을 수 있음 · **유력**) | `Labor_Ref` 쪽 걸음을 따라감 | 2-C5 · 855-E |
|
||||
|
||||
- 걷힐 것: `Hopyo_Ledger`(로직 장부 읽기 · 분석 C 「안 씀」) — 857-5 에서 지움.
|
||||
- **차례**: 보충 L1(이름표 싣기)이 먼저 있어야 Clause · Match · Units 가 문서 머리에서 같은 칸을 읽음 → 857-2 는 L1 뒤 · 857-3b 는 2-C2 · 2-C3 뒤. 보충 4-2 묶음 ⑦(L2 ⓒ)은 **857 에 합침**(따로 걸음 안 둠).
|
||||
|
||||
---
|
||||
|
||||
## 5. 「고를 재료」 판 첫 셈 · 저장본 무효
|
||||
|
||||
### 5-1 세기(`m857_census.py` · `m857_census_split.py` · `m857_prof.py` → `out_census*.json`)
|
||||
|
||||
| 파일 | 블록 | 판 첫 셈 초 | 그 안 재료 찾기 초 | 인력 초 | 재료 줄 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| 북부청임도 | 95 | 40.9 | 14.8 | 2.7 | 59 |
|
||||
| 봉화 | 65 | 28.3 | 8.7 | 1.1 | 36 |
|
||||
| 2026수목 | 142 | 21.2 | 9.1 | 6.1 | 72 |
|
||||
| 그 밖 8 | 15 ~ 374 | 4.2 ~ 25.4 | — | — | 0 ~ 64 |
|
||||
|
||||
프로파일(봉화 65 블록): **`m01.loaded()` 2,069 번 → `Store_Cache._stamps`(M01 파일 날짜 다시 잼 · `M01_MasterData_Store_Cache.py:57`) 누적 42.5 초 / 54.5 초**(약 80 %) · 기계 파일 목록 `master_machine_files.names:28` · `stamp:42` 2,069 번 · 별칭 책 `Elem_Alias.book:60` 591 번.
|
||||
|
||||
### 5-2 1 ~ 3 과 같이 풀리나
|
||||
|
||||
| 문제 | 1 ~ 3 으로 풀림? | 따로 할 것 |
|
||||
| --- | --- | --- |
|
||||
| 느림 | **아님** — 한 번 읽기 · 규칙 한 벌 · 문서 바로는 이 확인 횟수를 안 줄임 | **판 셈 · 블록 열기 · 저장 한 번 동안 M01 한 벌을 쥠**(요청 안 「M01 고정」 · 지금 `San_MatFind._CTX` 같은 ContextVar 꼴 · 결과 그대로) — 어림 30 줄 · 기대 = 수 초. 「재료 줄만 도는 길」(분석 C (나) 5)은 그 뒤에도 느릴 때만 |
|
||||
| 저장본 무효(`산근/<HP>.json` `재료판` · 무효 = HP 지움뿐 · `San_MatPick.py:194`) | **일부** — 3-2 둘째 박자 뒤에도 판은 그대로 남음 | 판에 **M01 지문 + 별칭 판 + 그 파일 고름 판**을 같이 적고 다르면 다시 셈(분석 C (나) 4 · 어림 10 줄) · 한 번 읽기(857-1)에서 `산근/<HP>.json` 꼴을 바꿀 때 같이 |
|
||||
| 셈 엔진 셋(읽기 투표 · 검산 · 최종) | 857-3b 로 검산 = 문서 셈 하나 | 읽기 끝전 투표(`San_Eval`)는 경쟁사 끝수 읽기라 남음 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 걸음
|
||||
|
||||
원칙: 두 박자(새 길로 바꿈 → 전수 다름 0 → 옛 길 지움) · 한 걸음 = 한 커밋 묶음 · 화면은 걸음마다 그대로 돎.
|
||||
|
||||
| 걸음 | 무엇 | 파일(어림 줄) | 지킴 | 위험 · 막는 법 | 화면 확인 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| **857-0 지킴 올림** | 3,241 블록 × 두 판 계 · 비목 · 검산 판정 · 이음 판정 지문 · 호표 쪽 HP 읽기 지문(엑셀 9 · 호표 · 단산 · 칠 표지 · 고정 줄) · 재료 이음 전후 표(`m857_mat` 꼴) | 새 `resources/tester/test_857_import_golden.py`(+ 250) · `helper_857.py` | 지금 수치 그대로 통과 | 원파일 견본 없는 PC = 건너뜀 · 전수는 환경 변수 | — |
|
||||
| **857-1 책 한 번 · 종류 한 말** | 새 「책 한 벌」(시트 목록 합집합 · 종류 가름 하나 · xls 서식 책) → `read_book` · `Grid` · `San_Book.sheets` 가 받음 · `_OPENED` 걷음 · 올림 = 산근 먼저(일위대가 없음 = 호표 빈 목록 · 400 아님) · `재료판` 무효 지문 | 새 `M02_San_Workbook.py`(+ 90) · `Hopyo_Excel`(− 60) · `Hopyo_Grid`(± 15) · `San_Book`(− 40) · `Hopyo_Router._upload`(± 20) · `Sangeun_FromHopyo.keep`(± 20) · `Hopyo_Stmate.is_stmate`(− 5) · `San_MatPick`(± 15) | 857-0 전부 같음 · 2016사방 · 2026수목 올림이 됨(HP 생김 · 단가산출 목록 516) · 올림 시간 전후 표 | 시트 선택이 계보마다 달랐던 것(STmate 단가산출근거만 있는 파일) — 견본 11 에서는 같은 판정 | 엑셀 · 원파일 올림 · 엑셀 보기 · 오른쪽 두 목록 |
|
||||
| **857-2 호표를 둘 꼴 위로 + L2 ⓒ 이름표** | 둘 꼴에 1-3 표 칸(보일 이름 · STmate 보이는 글 · 줄합 · EST 일위)을 더 싣고 `ReadEst` · `Stmate._blocks` · `UnitLine` · `Clause` 의 **입력을 둘 꼴 줄로**(몸은 둠) · `Clause` · `Match` · `Units` 의 로직 줄 읽기 → 문서 머리 | `Doc_FromNative.pack`(± 30) · `San_Xlsx_Est`(+ 60 · EST 일위) · `Hopyo_Excel.read_book`(± 80) · `Hopyo_ReadEst`(± 40) · `Hopyo_Stmate`(± 60) · `Hopyo_Clause` · `Hopyo_Match` · `Hopyo_Units`(± 40) | 호표 쪽 HP 읽기 지문 같음(505 블록 칸 전부) · 칠 · 고정 줄 · `test_621` · `test_m02_hopyo_*` · `test_812_1` · B09 내역서 시험 | B09 `Bill_Hopyo` 가 `read_book` 꼴을 먹음 — 꼴 유지 · `San_Basis_Index` 의 `trade` 를 가벼운 자리로(분석 C (나) 3) | 호표 목록 · 엑셀 칠 · [수정] 모달 · B09 내역서 불러오기 |
|
||||
| **857-3a 문서 바로(첫 박자)** | ㉡ → 문서를 불러오기 자기 모듈로(변환기 · `master.logic` · `mf.parse` 안 부름) | 새 `M02_San_ToDoc.py`(+ 350) · `Doc_Import.derive`(− 120) | 3,241 × 두 판 지문 같음 · 줄 꼴 지문 같음 · `test_802_4b1` · `test_810_2` · `test_848_*` 불러오기 줄 | 붙임 · 다듬기 다섯 단계(`_attach` · `_numbers` · `Shape` · `Q` · `NativeLayout`)가 변환기 결과 꼴에 기댐 — 한 단계씩 옮기며 지문 확인 | [가져온 식으로 열기] · 줄 쌓기 |
|
||||
| **857-3b SK 정본 = 문서(둘째 박자)** | `가져온.로직` 없앰 · 이음 고침 · 두 판 · 소요량 · 재료 고름 · 내 기계 · 초기화가 문서 연결을 고침 · 다시 열기 = 저장 문서 · `San_Basis_Index:160` 수식 문서로 · 옛 식 파서 부름 0 | `Sangeun_Imported`(− 250) · `Doc_Import`(− 200) · `Doc_Import_Reset` · `_Shape` · `Doc_NativeLayout` · `San_MatPick` · `San_MyMachine` · `Sangeun_QtyLinks`(± 150) · `San_Basis_Index`(± 40) · `Sangeun_FromHopyo`(± 40) · 화면 `Hopyo_Imported_Model.ts`(± 40) | 위 지문 · 저장 → 다시 열기 왕복 같음 · 이음 고침 · 초기화 시험(`test_793_2` · `797_2` · `827_3` · `848_3`) | 옛 SK 저장본 = 지금 시험 자료(요구 899 · 호환 안 만듦) — 저장본 비움(보충 3-2) 뒤 | 모달 [우리 단가로] · [엑셀 단가로] · [이음 고르기] · 소요량 · 초기화 |
|
||||
| **857-4 재료 찾기 한 벌** | 호표 길 `_mats` → `San_MatFind.find`(단서 포함) 후보 · 이음 관문 = 판단 거리 1 의 답(권함 = 「엑셀 단가 같은 후보 하나」 만 이음) · [수정] 모달 판정 말 같게 | `Hopyo_Fixed`(± 50) · `Hopyo_View`(± 20) · TS `Hopyo_View` 판정 글(± 20) | 857-0 고정 줄 지문 — 권한 안이면 금액 다름 0 · 이음 · 판정 바뀜 = `out_mat.tsv` 꼴 표로 뜻한 바뀜만 | 다른 품목 12 꼴(단가로 고르던 지역 · 판) — 「값 같은 쌍둥이 먼저」 를 호표 길에 남김 | [수정] 모달 후보 · 안 이은 줄 띠 |
|
||||
| **857-5 옛 길 지움** | 호표 쪽 시트 직접 읽기 · `_OPENED` · `Hopyo_Ledger` · 분석 C 「안 씀」 약 0.9 천 줄 · 소스 글자 시험 약 10 개 정리 · 옛 로직 줄 꼴 함수 | 위 파일들 · 시험 | 857-0 지문 · 관련 시험 전부 · `/openapi.json` 전후(뜻한 길만 빠짐) | — | 올림 · 두 목록 · 모달 한 바퀴 |
|
||||
|
||||
같이 돌릴 수 있는 묶음(파일 안 겹침):
|
||||
|
||||
| 묶음 | 걸음(창) | 겹침 확인 |
|
||||
| --- | --- | --- |
|
||||
| Ⓐ | 857-0(한 창) | 새 시험 파일만 |
|
||||
| Ⓑ | 857-1 · 857-3a · 857-4(세 창) | 책 · Router · San_Book · Hopyo_Excel 열기 ↔ 새 `San_ToDoc` · `Doc_Import.derive` ↔ `Hopyo_Fixed` · `Hopyo_View` — 다름 |
|
||||
| Ⓒ | 857-2 · 857-3b(두 창) | Hopyo 읽기 · Clause · Match · Units · pack ↔ Sangeun_Imported · Doc_Import · San_MatPick · QtyLinks · Basis_Index — `pack` 은 857-2 몫 · `San_Basis_Index` 는 857-3b 몫(`trade` 옮김도 그 창) |
|
||||
| 끝 | 857-5(한 창) | — |
|
||||
|
||||
꼭 차례인 까닭:
|
||||
- 857-0 먼저 — 「다름 0」 의 자.
|
||||
- 857-2 는 857-1 뒤(둘 꼴이 한 번 읽은 책에서 와야 호표가 그 위에 얹힘) · **보충 L1 뒤**(이름표가 문서 머리에 있어야 Clause · Match · Units 가 옮겨 감).
|
||||
- 857-3a 는 **본 설계 2-C2 · 2-C3 뒤**(옛 엔진 없이 열리고 검산되는 길 위에서 변환만 바꿈) · **2-E3 앞**(변환기 은퇴 전에 불러오기가 변환기를 안 부르게).
|
||||
- 857-3b 는 857-3a 뒤 · **저장본 비움 뒤**(보충 3-2 · 옛 `가져온.로직` 꼴 저장본 0).
|
||||
- 857-4 는 판단 거리 1 의 답 뒤 · 857-0 의 재료 이음 표가 기준.
|
||||
- 857-5 는 맨 끝 · 2-E4(엔진 · 옛 파서 지움)는 857-3b 뒤에야 불러오기 몫이 0.
|
||||
|
||||
걸음 2 와 맞물림 — 시작할 수 있는 때:
|
||||
|
||||
| 857 걸음 | 시작 가능 |
|
||||
| --- | --- |
|
||||
| 857-0 · 857-1 · 857-4 | **지금 바로**(걸음 2 와 파일 안 겹침 · 857-1 은 `Sangeun_FromHopyo.keep` 만 만짐) — 단 857-4 는 판단 거리 1 답 뒤 |
|
||||
| 857-3a | 2-C2 · 2-C3 끝 뒤(보충 묶음 ③ 뒤) |
|
||||
| 857-2 | 857-1 · 보충 L1(묶음 ④) 뒤 |
|
||||
| 857-3b | 857-3a · 저장본 비움(보충 묶음 ②) · 2-C5(`Hopyo_Build._inside` · `Sangeun_Imported._inner`) 뒤 |
|
||||
| 857-5 | 857 전부 · 856(화면 하나) 뒤(`Hopyo_*.ts` 화면 겹침) |
|
||||
|
||||
---
|
||||
|
||||
## 7. 사용자 판단 거리 · 못 본 것
|
||||
|
||||
### 7-1 판단 거리(쉬운 말)
|
||||
|
||||
1. **일위대가(호표) 불러오기의 재료 이음을 단가산출 불러오기와 맞출 때 「엑셀 숫자 그대로」 를 지킬지** — ㉠ 찾는 법만 맞추고 「엑셀 단가와 같은 품목」 일 때만 이음(금액 그대로 · 나머지는 후보로 보여 사람이 고름 · 권함) ㉡ 다 이음(9 파일에서 118 줄 이음이 바뀌고 109 줄 금액이 우리 단가로 바뀜) ㉢ 일위대가 고정 줄에도 「엑셀 값 · 우리 값」 두 판을 둠(일이 큼).
|
||||
2. **단가산출 불러오기도 단가를 볼지** — 지금은 이름 · 규격 · 단위로만 골라 지역 · 판이 다른 품목(북부청임도 돌망태 12 줄)을 고를 때가 있음. 「같은 이름 · 규격 쌍둥이 중 엑셀 단가와 같은 품목 먼저」 를 더할지.
|
||||
3. **일위대가 시트가 없는 엑셀(2016 사방 · 2026 수목 꼴)** — 지금은 화면 올림이 「일위대가 시트 없음」 으로 막힘. 한 번 읽기로 단가산출만 있는 파일도 올라가게 할지(권함 · 단가산출 목록만 보임).
|
||||
4. 「고를 재료」 판 — M01 · 별칭을 고친 뒤 판이 자동으로 다시 셈되게 할지(권함 · 몇 초 걸림).
|
||||
|
||||
### 7-2 못 본 것
|
||||
|
||||
- 원파일(EST 6 · STC 7 · 2,220 블록)은 견본 자리만 확인 · 세기는 엑셀 11 만(원파일은 호표 계보가 없어 1 · 2 절 대상 아님 · 3 절 지킴은 857-0 에서 같이 돎).
|
||||
- 재료 이음 세기는 일위대가 시트 호표 줄만 — 호표가 부르는 단산(SK 참조) 안 줄은 이미 단가산출 길이라 뺌 · 붙여넣기 · B09 내역서(`Linker(by_name=False)`) 길은 안 셈(관문이 더 좁음 · 같은 결론으로 봄).
|
||||
- 「금액 달라짐」 은 품목 단가 대 엑셀 재료비 단가만 맞댐 · SC 합계 · 내역서 금액 영향은 안 셈(건수만).
|
||||
- 판 첫 셈 「M01 한 벌 쥐기」 의 기대 시간은 프로파일에서 확인 부분을 뺀 어림(실측 아님) · 서버 · 화면은 안 돌림(파이썬 직접 · 저장 없음).
|
||||
- 호표 쪽 항목 계산(`ReadEst.items` · `Formula`)을 둘 꼴 줄 입력으로 바꿀 때 같은 결과가 나오는지는 857-2 에서 HP 지문으로 확인할 일(여기서는 칸 전수 · 만드는 곳 · 읽는 곳까지).
|
||||
- `Labor_Ref.Expand` 안의 로직 줄 읽기는 이름만 확인(유력).
|
||||
|
||||
### 세기 결과(`tmp/s894/m857/`)
|
||||
|
||||
| 도구 | 결과 | 무엇 |
|
||||
| --- | --- | --- |
|
||||
| `m857_read.py` | `out_read.json` | 책 열기 횟수 · 시간 · 두 계보 블록 대조 · 호표 쪽 단산 칸 |
|
||||
| `m857_mat.py` | `out_mat.json` · `out_mat.tsv`(바뀌는 118 줄) | 재료 이음 두 규칙 대조 |
|
||||
| `m857_l2.py` | `out_l2.tsv`(85 곳 · 19 파일) | 「로직」 낱말 · 로직 줄 읽기 자리 |
|
||||
| `m857_census.py` · `_split.py` · `m857_prof.py` | `out_census.json` · `out_census_split.json` | 판 첫 셈 시간 · 이음 몫 · 프로파일 |
|
||||
Reference in New Issue
Block a user