diff --git a/docs/raw/요구_1104/설계_856_단가산출화면하나.md b/docs/raw/요구_1104/설계_856_단가산출화면하나.md new file mode 100644 index 000000000..7fb94ed28 --- /dev/null +++ b/docs/raw/요구_1104/설계_856_단가산출화면하나.md @@ -0,0 +1,236 @@ +# 설계 856 — 걸음 3 「단가산출 화면 하나」 (PLAN 856) + +요구 896 · 898 · sub7 · 2026-11-17 · 읽기 · 세기만(코드 · 자료 · 시험 고침 0 · 화면 저장 0). 세는 도구 · 결과 = `tmp/s894/m856/`(4 절 끝 표). +바탕 = 분석 `_분석_894-D_화면.md`(아래 「D」) · 걸음 2 설계 `설계_855_정본하나_계산기하나.md`(「본 설계」) · 보충 `설계_855_보충_B09_로직JSON_호환.md`(「보충」) · `설계_858_서고한벌.md` 5 절 · `tmp/s894/c4/표시_자릿수.md`. + +## 0. 한눈 요약 + +- **옛 상세 몸이 보이는 곳은 이미 거의 없음** — M02 층(마스터 · 회사 · 개인)의 일위대가에서 단가산출 줄을 누르면 **벌써 줄 쌓기**(`Labor_SkEdit` → 그 SK 문서 · `Labor_Table.ts:338`)가 열림. 옛 줄 창(`Labor_RowModal` → `RowSk` → 상세 몸)은 **M01 로직을 바로 담은 줄**과 **프로젝트 사본(셈 주입)** 에서만 열림(`Labor_Table.ts:322-358`). 저장본에 그 줄은 **0**(SC 줄 28 = SK 참조 11 · SC 참조 2 · 고정 15 · M01 로직 줄 0 · 패치 0 / SK 14 의 덮개 · 뺀줄 · 더한줄 · 고름 · 자재표시 · 열린입력 값 0 · 프로젝트 사본 0). +- 그런데도 **상세 몸은 SK 를 열 때마다 숨긴 채 그려지고 서버 셈 두 번**(`Sangeun_Detail.ts:216-217` · `:301-360`) — 걷으면 SK 화면이 가벼워지고 `/sangeun/calc` 의 화면 손님이 **머리 띠 하나**로 줆. +- 사용자가 줄 창에서 하던 일 13 가지 중 **줄 쌓기가 대신하는 것 9 · 대신할 것 없음 2(재료 줄 관급 · 별도계상 표시 · 열린입력 배율) · 이미 죽음 2** (1 절 표). +- 걷는 화면 = M01 이름 2 파일(831 줄) + M02 9 파일(약 1.8 천 줄) — `LogicLab_Ho` · `_Cover`(M02 만 씀) · `Sangeun_Cover_Model` · `Undo` · `BaseHead` · `Sangeun_Cover` · `Sangeun_Unit` · `Labor_RowSk` + `Sangeun_Detail` · `RowModal` 절반. 서버 쪽 화면 0 이 되는 것 = `/sangeun/calc` 길 · 덮개 · 뺀줄 · 더한줄 · 패치 셈(26 파일 269 자리 — 2-E2 로 넘김). +- **자릿수** — 지금 화면엔 「원문 자릿수로 보임」 규칙이 **없음**(셈 값을 소수 여섯 자리까지). 품셈 1 장에 단위 · 소수 자리 규정이 있음(건설 1-2-1 · 1-2-2 · 8-1 주① · 산림 1-2-1 · 1-2-2) → 후보 셋 · 권함 = 「원문 글자 자리 + 갈래 기본 자리」 한 규칙(값은 사용자 확정). +- 차례: **856-1(상세 몸 걷기)은 지금 바로 가능**(자료 0 · 서버 안 건드림) · 856-2(머리 띠를 문서 답으로 · `/sangeun/calc` 화면 0)는 **2-C1 뒤** · 856-3(프로젝트 사본 줄 = 줄 쌓기 보기)은 **B9-5 뒤** · 자릿수(856-5)는 사용자 확정 뒤. + +--- + +## 1. 일위대가 줄 창을 줄 쌓기로 + +### 1-1 지금 줄을 누르면(`Labor_Table.ts:322 openAt`) + +| 줄 갈래 | 지금 열리는 창 | 저장본 수(`census_rows.py`) | +| --- | --- | --- | +| SC 참조(일위대가 속 일위대가) | `Labor_RefEdit`(그 SC 표) | 2 | +| 고정 | 안 열림(숫자 그대로) | 15 | +| **SK 참조 · M02 층** | **`Labor_SkEdit` = 그 SK 문서 줄 쌓기**(`:338` · 806-1) — 이미 「한 화면」 | 11 | +| SK 참조 · 셈 주입(프로젝트 사본 카드 `ItemCards.ts:334`) | `Labor_RowModal` → `RowSk` → 상세 몸 | 0(프로젝트 사본 0) | +| **M01 로직 바로 담은 줄** | `Labor_RowModal` → `RowSk` → 상세 몸(`lineDoc` = 키 `SK-000000` 줄 문서) | 0 — M02 층 [로직 더하기]는 811-1 부터 SK 사본 참조로 담음(`Labor_Table.ts:462-473`) · 프로젝트 층 · 셈 주입만 아직 로직 줄 | +| 사용자 자재 | `openMatModal`(세 칸 · 가격 보기) | 0 | + +→ 856 의 「줄 창을 줄 쌓기로」 = 남은 두 갈래(M01 로직 줄 · 셈 주입 SK 줄)를 없애거나 줄 쌓기로 돌림. + +### 1-2 줄 창에서 하던 일 → 줄 쌓기가 대신하는 것 + +| 줄 창에서 하던 일(근거) | 저장 칸 | 줄 쌓기의 같은 일 | 판정 | +| --- | --- | --- | --- | +| 입력 칩 · 박스 옵션 고르기(`Sangeun_Detail.ts:418 onInput` · `RowSk.ts:83 values`) | 줄 `입력값` | 옵션 가로(`formula_doc_options`) — SK 문서 자기 입력 | **대신함**(줄마다 SK 하나 = 사본이라 줄 입력 = 그 SK 입력) | +| 품 · 비목 단가 덮기(`HoEdit.set` → `Cover_Model.ts:347 setLineCover`) | `덮개` · 줄 `패치.덮개` | 금액 줄 수량 식 · 단가 칸 바로 고침(문서 고침 = `따로`) | **대신함** | +| 줄 빼기(`Sangeun_Detail.ts:368 dropLine`) | `뺀줄` | 금액 줄 지움 | **대신함** | +| 뺀 줄 되살림 띠(`removedStrip` · `restoreLine`) | `뺀줄` · `뺀더한줄` | 줄 쌓기 [되돌림] · 바뀐 자리 표시(`line_stack_diff`) · [초기화] | **대신함**(되살림 목록 대신 되돌림) | +| 기초 · 줄 더하기(`Sangeun_Pick` · 더한줄) | `더한줄` | [+ 줄] 메뉴(단가산출 복사 · 요소 · 기계) | **대신함** | +| 더한 기초 수량 · 되돌림 · 기초 빼기(`BaseHead` `onQty` `onReset` `onDrop`) | `더한줄[k].수량` | 넣은 단가산출 줄 수량 식 · 줄 지움 | **대신함** | +| 재료 고르기(`pickMat` → `고름` cid→MT) | `고름` | 재료 줄 고르기(`line_stack_pick` · `_material`) | **대신함** | +| 이름 · 단위 · 단위 환산(`drawHead` · `Sangeun_Unit` `buildUnitSwap`) | `이름` `단위` `환산` | SK 화면 머리(남김 — 몸이 아니라 머리) | **남김** | +| 머리 띠(까닭 · 빠진 줄 · 짝 잃음 · M01 개정 · 「셈 머리」 배지) | — | 2 절 — 줄 쌓기 답 · 문서 읽기 알림으로 | **옮김**(856-2) | +| 줄 재료 관급 · 별도계상 · 세 칸 표시(`RowModal.ts:96 logicMatRows mark` · `setApart`) | 줄 `자재표시` · SK `자재표시` | **없음** — 줄 쌓기의 「별도계상」 은 불러온 재료 표지뿐(`line_stack_material.ts:71-86`) | **대신할 것 없음** — B09 가 SK `자재표시` 를 대비표 기본 표시로 읽음(841-1) · 저장본 값 0 · 판단 거리 1 | +| 열린입력 배율(`Cover_Model.ts:363` 열린입력 SK = 품 대신 배율) | `열린입력` · `덮개.배율` | 없음 | **대신할 것 없음** · 저장본 값 0 → 걷음(호환 안 만듦) | +| 켜쌓기율 · 메모 보기(`RowModal.ts:79-80`) | 줄 `켜쌓기율` `메모` | 메모 = 일위대가 표 칸 그대로 · 켜쌓기율 = 로직 줄 전용(값 0) | 메모 남김 · 켜쌓기율 **걷음**(로직 줄과 같이) | +| [적용] = 줄에 패치 · 입력값 남김(`RowModal.ts:146-161`) | 줄 `패치` `입력값` | SkEdit [저장] = 그 SK 문서 저장(`Labor_SkEdit.ts` 머리) | **대신함**(저장 길이 SK 문서 하나) | + +### 1-3 `SK-000000` 줄 문서 약속 · 저장 꼴 + +- 지금 — 키 글자로 화면 모드가 갈림: `/^SK-(?!0{6})\d{6}$/`(`Sangeun_Detail.ts:118 · 319`) → 저장한 SK = 줄 쌓기 · `SK-000000`(`lineDoc` · `Cover_Model.ts:584`) = 상세 몸. +- 바꿈 — 줄 문서가 없어지므로 약속을 걷고 **모드를 옵션으로**: `mode: "page"`(단가산출 화면) · `"ref"`(SkEdit — 저장한 SK) · `"memory"`(불러오기 미리 보기 · 프로젝트 사본 SK 보기 — `line_stack_screen.ts:17 · 157` 의 `memory` = 보기만 · 디스크 쓰기 0). 키 정규식 두 곳 지움. +- 저장 꼴 — 일위대가 줄 = **`{참조: {층, 주인, SK}, 별칭, 메모, 수량}` 한 행**(`M02_Labor_SkRow.py` 머리 · 811-1) 그대로. 걷는 칸 = 줄 `패치` · `입력값` · `고름` · `자재표시` · `켜쌓기율` · `로직`(로직 줄 자체) — 저장본 값 0 · 호환 안 만듦(요구 899). +- 남은 로직 줄 길 둘을 닫음: + - **프로젝트 층 [로직 더하기]**(`Labor_Table.ts:462` `own` 이 프로젝트 층을 뺌) → M02 층처럼 그 층 SK 사본 참조로(`skFromLogic` · 프로젝트 층 `templates/sangeun` — 지금 0). + - **셈 주입(프로젝트 사본 카드)의 SK 줄** → 사본 안 SK 수식 문서를 `memory` 줄 쌓기로 **보기만**(프로젝트는 고치지 않음 · 고침 = M02 에서 고쳐 [재생성] · 요구 898 ①). 사본 꼴이 수식 문서 사본이 되는 B9-5 뒤. + +--- + +## 2. 상세 몸 걷기 + +### 2-1 걷는 화면 파일(`census_imports.py` · 결과 `out_imports.tsv`) + +| 파일 | 줄 | 부르는 곳 | 걷은 뒤 | +| --- | --- | --- | --- | +| M01 `UI_LogicLab_Ho` | 689 | M02 `Sangeun_Detail` 하나 | **지움**(M01 이름 · M02 만 씀) | +| M01 `UI_LogicLab_Cover` | 142 | `LogicLab_Ho` 하나 | **지움** | +| M01 `UI_LogicLab_Detail` | 162 | M01 `LogicLab` + M02 `Sangeun_Detail` | **남김**(M01 보기 넷 그대로) · M02 부름만 뺌 | +| M01 `UI_LogicLab_Modal` | 574 | M01 `LogicLab` · `CalcPick` · `LogicLab_Ho` · M02 `Labor_LogicMats` | 남김(`Ho` 부름만 빠짐) | +| M02 `logic/Sangeun_Cover_Model` | 627 | `Labor_Api`(타입 `LinePatch`) · `RowSk` · `BaseHead` · `Sangeun_Cover` · `Sangeun_Detail` · `Undo` | **지움**(`LinePatch` 타입도 · 줄 `패치` 칸 걷음) | +| M02 `logic/Sangeun_Undo` | 93 | `Sangeun_Detail` · `Cover_Model` | **지움** | +| M02 `Sangeun_BaseHead` | 92 | `Sangeun_Detail` | **지움** | +| M02 `Sangeun_Cover` | 72 | `RowModal` · `RowSk` · `Sangeun_Detail`(`calcSangeun` · `removedStrip`) | 856-1 = `removedStrip` 지움 · 856-2 = 파일 지움 | +| M02 `Sangeun_Unit` | 103 | `Sangeun_Detail` 머리 | 남김(머리 단위 환산) — 856-2 에서 바탕 정보를 문서에서 받으면 같이 정리 | +| M02 `Labor_RowSk` | 101 | `RowModal` | **지움** | +| M02 `Labor_RowModal` | 240 | `Labor_Table` | 로직 줄 · 상세 · [적용] 걷음 → 자재 모달(`openMatModal`)만 남음(약 −150) | +| M02 `Sangeun_Detail` | 497 | `Sangeun_View` · `SkEdit` · `RowSk` · `Hopyo_Imported` | 몸 · `bare` 셈 · `hoEdit` · `pickMat` · `buildLabDetail` 부름 · 키 정규식 걷음(약 −250 → 250 안팎) | +| M02 `Sangeun_Tabs` | 85 | `Sangeun_Detail` | `editor` 숨김 · `show` 걷음(약 −15) | +| M02 `Labor_LogicMats` + `_Model` | 160 + 53 | `RowModal` · `Labor_View`(면적 오른쪽 보기) · `Labor_Calc` · `Labor_Table` | 남김 — 로직 줄이 없어지면 856-3 에서 다시 셈 | + +합 = 지움 약 **1.9 천 줄**(M01 0.83 · M02 1.05) + 줄임 약 0.4 천. 글 키(`M02_Sangeun*` · `Sk*` 덮개 · 뺀줄 글)도 같이. + +### 2-2 머리 띠를 문서 셈 답으로(856-2) + +| 머리 띠 | 지금 근거(`/sangeun/calc` 답 · `Sangeun_Detail.ts:248-284`) | 바꿀 근거 | +| --- | --- | --- | +| 까닭(빨강) | `ans.까닭` · 요청 실패 | 줄 쌓기 브라우저 셈 답 `표지`(계산기 한 벌 · 빈 값 까닭) — 이미 화면 안에 있음 | +| 빠진 줄(노랑) | `ans.빠진줄` | 문서 읽기 답의 빈틈(`M02_Doc_Gap` — [저장] · [단가 갱신] 때 채움 · 열 때 표지) | +| 짝 잃음(노랑) | `ans.짝잃음`(덮개 cid 가 줄을 잃음 · `Sangeun_Copy` 재생성 못 얹은 칸) | 덮개가 없어지므로 **재생성 못 얹은 칸만** — [재생성] 답(`formula_doc_copy`)이 이미 보여 줌 | +| M01 개정(빨강 배지) | `doc.바탕판` 대 `ans.바탕판` · `revisedAdds` | M01 자동 따라옴 알림(`formula_doc_renew` · `M02_Sk_AutoRenew` · 848-2)이 대신 — 「바탕판」 칸은 2-D 에서 걷힘(본 설계 5-1) | +| 셈 머리 배지(「계」 · 「합계」) | `ans.머리` | 브라우저 셈 답 `머리` | + +- `recalc` 의 두 번 셈(`:214-218` — 바탕 원값 `bare` = 몸의 「원래 값」 칸용)은 **856-1 에서 한 번으로**(몸이 없으면 `bare` 쓰는 곳 0). +- 856-2 뒤 화면이 `/sangeun/calc` 를 부르는 곳 = 0(`calcSangeun` 부르는 곳 = `Sangeun_Detail:216-217` · `RowSk:53` 셋뿐 · 1 · 2 절에서 모두 걷힘). +- 2-C1 과 맞물림 — 2-C1 은 `/sangeun/calc` 답 꼴을 지키며 속을 문서 셈으로 바꿈. 856-2 가 화면 손님을 0 으로 만들면 **그 길은 일위대가 합산 속 SK 셈(서버 안 `Sangeun_Calc.run`)만 남음** → 2-C1 이 「답 꼴(줄 cid · 덮개 표지 · 빠진줄 · 정체 · 배)」 가운데 화면용 칸을 지킬 필요가 줆. + +### 2-3 걷은 뒤 서버 쪽에서 화면 0 이 되는 것(2-E1 · 2-E2 로 넘길 목록 · `census_server.py` · 결과 `out_server.tsv`) + +| 갈래 | 자리 | 넘김 | +| --- | --- | --- | +| 길 | `POST /layers/{층}/sangeun/calc`(`M02_Sangeun_Router.py:71`) | 2-E2(856-2 뒤 화면 0 · 서버 안 셈만 남음) | +| 덮개 · 뺀줄 · 더한줄 · 열린입력 · 배율 셈 | `Sangeun_Calc`(45 자리) · `Sangeun_Doc`(33) · `Sangeun_Const`(29) · `Library_Flat`(45 — 넣기 펼침) · `Library_Same`(13) · `Library_Delete`(9) · `Doc_Sk`(10) · `Sangeun_Formula`(9) · `Sangeun_Imported`(9) · `Doc_Import_Reset`(6) · `Sangeun_Copy`(6) · `Item_Sangeun`(8) | 2-E2 · 2-D(칸 걷음) — 저장본 값 0 · 호환 안 만듦 | +| 일위대가 줄 패치 | `Labor_Patch`(10) · `Labor_Ref`(7) · `Labor_Copy`(2) · `Doc_Take`(1) · `Labor_SkRow.to_sangeun` | 2-E2 · 856-3(로직 줄 0 뒤) | +| 상세 몸 풀이 글 · 시트 | `Sangeun_Views.text_of` · `Sangeun_Const._mids · sheet` · M01 `/text`(`Store.text` · M02 감쌈 `Logic_Lib_Read.py:67`) | 2-E1 · 2-E2(본 설계 4-1 「856 뒤」) | +| B09 「덮개」(702 · B09 자기 덮개 — 다른 뜻) | `Daega_Personal`(9) · `Labor_Source`(7) · `Past`(2) · `Calc_Labor`(1) | **넘기지 않음**(낱말만 같음 · B9 걸음 몫) | + +### 2-4 그 밖에 같이 정리 + +- `setLogicApiPaths` 전역(`Sangeun_Detail.ts:85` · 되돌림 없음 · D 4-3) — 몸이 걷히면 M02 가 M01 `Logic_Api` 를 쓰는 곳 = 머리 바탕 정보(`fetchLogic`) · 원문 패널(`tabOf`)만 → **M02 길을 인자로 넘기는 작은 읽기 함수**로 바꾸고 전역 걷음. +- 시험(몸만 붙든 것 · 이름 자리) — 지움 후보: `test_717_2b` · `717_3` · `722` · `725_1` · `737` · `740_2` · `750_2` · `796_2d` · helper `728_2` · `748_0`(+ `727_sk_base_add` 의 몸 부분) · 고침 후보(살아 있는 결과도 봄): `723_labor_table` · `806_1_labor_view` · `175_precombo_mats` · `222_1_m02_apart` · `m02_labor_logic_mats` · `m02_labor_mat_marks` · `799_2` · `804_*` · `836_5`(키 정규식 → 모드 옵션) — 걸음마다 그 자리만. + +--- + +## 3. 공용 폴더가 M02 를 거꾸로 부르는 것 + +### 3-1 지금(실측 · `grep import`) + +| A00 파일 | 부르는 M02 · M01 | 쓰는 것 | +| --- | --- | --- | +| `line_stack_screen.ts:73` | M02 `Api_Fetch` | `Layer` 타입만 | +| `line_stack_pick.ts:25-26` | M02 `Api_Fetch` · `Find_Pick` | `Layer` 타입 · `openFindPicker` | +| `line_stack_rows.ts:48` | M02 `Find_Pick` | `openFindPicker` | +| `line_stack_machine_ctl.ts:49` | M02 `Find_Pick` | `openFindPicker` | +| `line_stack_machine.ts:17-27` | M02 `Api_Fetch` · `MyMachine_Api` · `MyMachine_Form` · `MyMachine_Text` | `call` · 내 기계 목록 · `hourlyText` · 글 `mt` | +| `line_stack_material.ts:15-17` | M02 `Api_Fetch` · `Hopyo_Api` · M01 `Api_Fetch` | `call` · `at` · `placeNote` | +| `line_stack_edit.ts:59` | M02 `DataFlow/DF_UnitPick` | `createUnitPick` · `NO_UNIT` | +| `formula_doc_options.ts:14-15` | M02 `DataFlow/DF_Api` · `MyMachine_Text` | 기계 이름 · `mt` | +| `formula_doc_foot.ts:8-9` | M01 `LogicLab_Foot` · `LogicLab_Style.css` | `buildFoot` | +| `ui_template_item_picker_{detail,edit,project}` | M02 `Api_Fetch` · `Labor_Api` · `ItemCards` · `ItemSource` · `Values_Model` · `Drawing` · `Labor_Values` | 대부분 타입 · `readTemplate` · `calcLabor` | +| 순환 | `line_stack_machine_ctl ↔ line_stack_machine_work`(D 1-3) | — | + +### 3-2 끊는 꼴 · 범위 + +| 거리 | 꼴 | 856 에서 | 까닭 | +| --- | --- | --- | --- | +| `Layer` 타입 · `call`(길 부르기) | common_util 로 옮김(타입 · 얇은 부르기 한 함수) | **함** | 작음 · 3 파일 · 동작 불변 | +| `openFindPicker`(3 곳) | `createStackScreen` 옵션 `pick?: (kind, …) => …`(주입 훅) · M01 · M02 가 넘김 | **함** | 줄 쌓기가 M02 없이 돎의 핵심 · 856-1 에서 `Sangeun_Detail` 을 만질 때 같이 | +| `DF_UnitPick`(단위 고르기) · `DataFlow/` 이름 | 부품 상자로 옮김(`ui_template_unit_pick`) — 화면 요소 규칙과 맞음 | **함** | 이름 혼선(D 4-4) 해소 · 이동만 | +| `LogicLab_Foot` · `_Style.css`(M01 → A00) | A00 로 옮김(합계 상자는 공용) | **함** | 2 파일 이동 | +| 기계 창 · 내 기계(`MyMachine_*` 4) · `formula_doc_options` 기계 이름 | 주입 훅 `machine?: {list, hourly, names}` | **미룸 → 858**(서고 한 벌 5-6 이 내 기계 Api 를 「종류 + 층」 함수로 바꿈) | 858 과 같은 파일 | +| 불러온 재료 표지(`Hopyo_Api.at` · M01 `placeNote`) | 주입 훅 `material?` | **미룸 → 857**(불러오기 한 번 읽기) | 857 과 같은 파일 | +| `ui_template_item_picker_*` → M02 | 부품 상자가 M02 를 부르는 것 — 타입은 common_util · 함수는 주입 | **미룸**(구조물 조합 카드 · B08 이 씀 · 화면 하나와 무관) | 범위 밖 | +| `ctl ↔ work` 순환 | 둘이 같이 쓰는 타입 · 상수를 `line_stack_machine_types.ts` 로 | **함**(타입만 · 동작 불변) | 작음 | +| M01 이름 파일을 M02 만 씀(`LogicLab_Ho` · `_Cover`) | 2 절에서 지움 | **함** | — | + +--- + +## 4. 보이는 수의 자릿수 + +### 4-1 지금 규칙과 사용자 뜻의 차이 + +| 보이는 값 | 지금 규칙(코드) | 원문 규정(지식DB) | 차이 | +| --- | --- | --- | --- | +| 표 값(품 · 수량 · 계수) | `eqText` = 셈 값 그대로 · 소수 여섯 자리까지 · **끝 0 뗌**(`ui_template_equation.ts:169-185`) | 원문 표 글자 자리(예 산림 13-4-2 석공 「0.10」) | 끝 0 이 사라짐 — 「0.1 인」(2-C4 계산서 사진) · 표 JSON 자체에 끝 0 이 남은 수 4,775 / 소수 25,726 · 끝 0 없는 표 파일 25 / 83(`census_places.py`) — 예 `소요량_산림품셈_13장_구조물.json:18` 「석공」: 0.1 | +| 식이 낸 중간 값 · 품(시간당 · ÷ 작업량) | `eqText`(여섯 자리) | 건설 1-2-1 2 「지정 소수자리 아래 1 자리까지 산출 · 반올림」 · 1-2-2 1 단위표준(직공인부 인 2 자리 · 토적 ㎥ 2 · 면적 ㎡ 1 …) · 1-2-2 3 시공단위 품 = 일당시공량 1 단위 이하 2 · 10 단위 3 · … 10,000 단위 6 자리 · 8-1 [주]① Q 3 · n 2 · cm 3 자리 사사오입 · 산림 1-2-1 1 「인원 · 재적 셋째 자리 반올림 · 둘째 자리 표시」 | 0.027778(1 ÷ 36 hr)처럼 여섯 자리 — 공식 줄 651 · 금액 줄 수량 1,645(`표시_자릿수.md`) | +| 율 줄 단가(노무비 × 3 % 등) | `eqText` | 규정 없음(금액이 아니라 밑수) | 33,971.813333 — 317 | +| 줄 금액 | 소수 한 자리(`line_stack_out.ts` `one` · 셈 끝수 뒤 값) | 건설 · 산림 1-2-2 2 금액 단위표준 「일위대가표의 금액란 0.1 원 미만 버림」 | **맞음** | +| 비목 · 계 · 합계 | 원(`won` · 셈 끝수 뒤) | 「일위대가표의 계금 1 원 미만 버림」 | **맞음** | +| 기계 시간당 단가 | 기계 문서 셈 끝수 뒤(대개 원) | 8-1 기계경비 산정 | 대개 맞음(2-C4 계산서에서 21,846 원/시간) | + +근거 자리 — 건설 `resources/knowledge/original/원가계산/건설공사_표준품셈/본문/01_공통부문/제01장_적용기준/1-02_설계_및_수량.md:21-22`(1-2-1) · `:40-125`(1-2-2 1 표 · ①②③ 주) · `:127-139`(1-2-2 2 금액) · `:604-616`(1-2-2 3 품 자리) · `…/제08장_건설기계/8-01_적용기준.md:123-126` · 산림 `resources/knowledge/original/원가계산/산림_표준품셈/본문/제01장_적용기준/1-02_설계_및_수량.md:21-22 · 53-59 · 141-149`. + +- 원문 자리를 **알 수 있는 값** = 원문 표 숫자(표 JSON 글자 — 단 끝 0 이 빠진 표가 있음) · 원문 상수(식 안 숫자 글자) · 단위표준 표의 종목(단위로 찾음) · 금액 칸. +- **알 수 없는 값** = 식이 낸 중간 값 · 율 줄 단가 · 입력값(사용자) · 기계 손료 계수 셈. +- 셈은 이미 정밀(Decimal · 끝수는 문서 칸 · 식 안 반올림 함수) — 「보일 자리」 는 **그림만** 바꾸는 일. + +### 4-2 길 후보 + +| 후보 | 하는 일 | 좋은 점 | 나쁜 점 | +| --- | --- | --- | --- | +| ㉮ 갈래별 기본 자리 | 한 규칙 표 — 단위(인 · 시간 · ㎥ · ㎡ · m …) · 갈래(품 · 수량 · 단가 · 금액)마다 보일 자리(1-2-2 표 · 8-1 주①에서 고름) | 문서 · 자료 고침 0 · 짧음 | 원문 표가 3 자리인 품도 갈래 자리로 깎이거나 늘어남 | +| ㉯ 문서 칸 「보일 자리」 | 수식 문서 변수 · 금액 줄 수량 칸에 `자리`(그림 전용) · 빌더 · M01 [저장]이 원문 표 글자 자리 · 단위표준으로 채움 · 화면 · 서버 글이 읽음 | 원문과 줄마다 맞음 · 사용자가 고칠 수 있음 | 문서 1,521 · 표 끝 0 빠진 25 파일 보강 · 거울 시험 · 걸음 큼(로직 JSON 없애기 L1 과 같은 때가 쌈) | +| ㉰ 셈 자체를 원문 규정대로 반올림 | 1-2-1 2 「지정 자리 아래 1 자리 산출 · 반올림」 을 셈에 | 원문 글 그대로 | 「계산은 정밀」 과 어긋남 · 금액이 바뀜(전수 다름) | + +**권함 = ㉮ 를 먼저(기본) + 표 값만 글자 자리 그대로(끝 0 이 남은 표는 그 자리 · 없으면 ㉮)** — 화면 TS(`eqText` 앞 한 규칙) · 서버 풀이 글(`master_doc_text.eq_text` · 2-C4 짝)이 **같은 규칙 파일 한 쌍**(거울 시험)을 씀. ㉯ 는 L1(이름표 칸 싣기)과 같은 때 다시 판단. **자리 값(표)은 정하지 않음 — 사용자 확정**(판단 거리 2). + +--- + +## 5. 고치는 중 값 보관 + +| 화면 | 지금 | 856 뒤 | +| --- | --- | --- | +| 단가산출(SK) 화면 · SkEdit(일위대가 속 SK) | sessionStorage `m02_sk_doc_drafts`(SK 키별 · `line_stack_screen.ts:185 · 197 · 629` · `Sangeun_Tabs.ts:56`) | 그대로 — 줄 창이 줄 쌓기가 되면 **줄 속 SK 고침은 새로고침을 견딤** | +| 일위대가(SC) 표 자체(줄 차례 · 수량 · 별칭 · 메모 · 자재) | 메모리 + 떠날 때 `confirmLeave`(11 파일 · 858 5 절) | 그대로(856 범위 밖) | +| 상세 몸 고침(덮개 · 뺀줄 …) | 메모리(모달 닫으면 [적용] 전 버림) | 없어짐 | +| 프로젝트 사본 SK 보기 | 메모리 | `memory` 보기만 — 보관할 고침 없음 | + +- 858 이 「856 이 줄 창을 줄 쌓기로 바꾸면 SC 도 같은 보관을 얻음」 이라 맡김 → **반만 맞음**: 얻는 것은 SC 안 SK 고침뿐 · SC 표 자체는 메모리. +- **제안** — 856 은 넘기지 않음(SC 표 sessionStorage 는 따로 작은 걸음 · 열쇠 `m02_labor_drafts` · 표 문서 통째 · [저장] 때 비움 · 같은 SC 를 SkEdit 저장이 바꾸면 판 대조로 막음). 원하는지 = 판단 거리 4. + +--- + +## 6. 걸음 + +원칙 = 한 걸음 한 길 · 두 박자(새 길로 바꿈 → 화면 · 시험 같음 → 옛 길 지움) · 걸음마다 커밋. + +| 걸음 | 무엇 | 파일(어림 줄) | 지킴 | 위험 · 막는 법 | 화면 확인 | 앞 조건 | +| --- | --- | --- | --- | --- | --- | --- | +| **856-0 지킴** | 가짜 DOM 시험 — ① SK 화면 열 때 `/sangeun/calc` 부름 수 · 숨은 몸 DOM 0 ② 일위대가 SK 줄 누름 = 줄 쌓기 ③ 머리 띠 넷이 뜨는 경우(견본 답) ④ M01 로직 상세 그대로 | 새 시험 1 + helper(+ 200) | 지금 수치 그대로 | — | — | 지금 | +| **856-1 상세 몸 걷기** | `Sangeun_Detail` 몸 · `bare` 셈 · `hoEdit` · `pickMat` · `buildLabDetail` · 키 정규식 → 모드 옵션 · `RowSk` · `Cover_Model` · `Undo` · `BaseHead` · M01 `LogicLab_Ho` · `_Cover` 지움 · `RowModal` 로직 줄 갈래 · 줄 패치 타입 걷음 | M02 7 · M01 2 · 시험 약 10(− 1.9 천 · 시험 −) | 856-0 · `npm run typecheck` · `test_806_1` · `723` · `804_*` · `836_5` · `854_3`(누수) · 관련 시험 전부 | 로직 줄 · 셈 주입 줄을 누르면 열 창이 없어짐 → 856-3 까지 **안내 띠 한 줄**(「단가산출로 담아 쓰세요」 · 저장본 0 · 프로젝트 사본 0) | M02 단가산출 열기 · 일위대가 SK 줄 누름 · 불러오기 가져온 식 미리 보기 · M01 로직 상세 | 없음(지금 바로 · 2-C1 과 파일 안 겹침 — `Sangeun_Calc` · `Doc_Sk` 안 만짐) | +| 856-2 머리 띠 = 문서 답 | 띠 넷 근거를 줄 쌓기 셈 답 · 문서 읽기 알림으로 · `calcSangeun` · `Sangeun_Cover` 지움 · `setLogicApiPaths` 전역 걷음 | `Sangeun_Detail`(± 80) · `Sangeun_Unit`(± 20) · M01 `Logic_Api`(± 10) | 856-0 ③ · 화면 `/sangeun/calc` 부름 0 · `/openapi.json` 그대로(길 지움은 2-E2) | 「빠진 줄」 이 [저장] 때만 채워짐 — 열 때 표지 문구 확인 | 띠 넷(견본 SK) | 2-C1(`/doc` 답 꼴 · 빈틈 표지) | +| 856-3 남은 로직 줄 길 | 프로젝트 층 [로직 더하기] = SK 사본 참조 · 셈 주입 SK 줄 = `memory` 줄 쌓기 보기 · `RowModal` = 자재 모달만 · `Labor_LogicMats` 정리 | `Labor_Table`(± 30) · `RowModal`(− 150) · `ItemCards`(± 10) · `Labor_SkPick`(+ SK 사본 만드는 서버 길이 프로젝트 층을 받는지 확인 · ± 20) | B9 골든(`test_855_b09_golden`) · 사본 카드 화면 | 프로젝트 층 SK 서고 쓰기 권한 | B08 구조물 카드 일위대가 줄 | B9-5(사본 = 수식 문서 사본) | +| 856-4 거꾸로 부름 · 순환 | 3-2 「함」 줄(타입 · `call` → common_util · `pick` 훅 · 단위 고르기 · 합계 상자 이동 · `ctl ↔ work` 타입) | A00 6 · M01 2 이동 · M02 3(± 150) | typecheck · 줄 쌓기 가짜 DOM · `test_804_*` | import 경로만 — 동작 불변 | M01 · M02 줄 쌓기 [+ 줄] 고르기 · 기계 제어 구역 | 856-1(같은 `Sangeun_Detail`) | +| 856-5 보일 자리 | 4-2 권함 규칙 한 쌍(TS · PY) + 거울 시험 · `eqText` 앞 · `master_doc_text` | common_util 새 1(+ 120) · `master_doc_text`(± 30) · A00 `line_stack_out` · `_rows` · `calc_sheet`(± 30) | 거울 · 금액 불변(그림만) | 자리 표 값 = 사용자 확정 | 단가산출 오른쪽 · 계산서 · 일위대가표 | 사용자 확정 | +| 856-6 옛 길 지움(둘째 박자) | 856-2 뒤 서버 `/sangeun/calc` · 덮개 셈 목록(2-3 절) | → 2-E2 에 넘김(856 은 목록만) | — | — | — | 856-2 · 2-C1 | + +같이 돌릴 수 있는 묶음 — **856-0 → 856-1 은 지금(보충 묶음 ③ 의 2-C1 · 2-C3 · B9-2 와 파일 안 겹침)** · 856-4 는 856-1 뒤 같은 창 · 856-2 는 2-C1 뒤(보충 묶음 ④) · 856-3 은 B9-5 뒤(묶음 ⑤) · 856-5 는 확정 뒤 아무 때(파일 다름). 2-E1 · 2-E2(묶음 ⑥)는 856-2 뒤. + +--- + +## 7. 사용자 판단 거리 · 못 본 것 + +### 7-1 판단 거리(쉬운 말) + +1. **단가산출 속 재료 줄의 「관급 · 별도계상」 표시** — 옛 줄 창에는 있었고 새 단가산출 화면(줄 쌓기)에는 없음. 지금 쓰는 자료는 0 개. ㉠ 줄 쌓기 재료 줄에 표시 칸을 새로 둠(B09 대비표가 읽음) ㉡ 일위대가 표의 재료 칸에서만 표시(단가산출 안에서는 안 함) ㉢ 뺌. +2. **보일 자리** — 화면 숫자를 품셈 원문 자리로 보이려면 「단위 · 갈래마다 몇 자리」 표를 정해야 함(예: 인 = 2 자리 · 시간 = ? · ㎥ = 2 자리 · 율 줄 단가 = ?). 원문 표의 「0.10」 처럼 끝 0 도 살릴지. 셈은 그대로 정밀. +3. **프로젝트 사본의 단가산출 줄** — 프로젝트(구조물 카드)에서 단가산출 줄을 누르면 「보기만」(고침은 M02 에서 고쳐 [재생성]) — 맞는지. +4. **일위대가 표 자체의 고치는 중 값** — 지금은 새로고침하면 사라짐(떠날 때만 물음). 단가산출처럼 새로고침을 견디게 할지(따로 작은 일). + +### 7-2 못 본 것 + +- 화면을 열어 보지 않음 — 줄 창 · 머리 띠 동작은 코드 흐름 · 저장본 세기로 판정. 856-0 의 가짜 DOM 시험이 실제 확인 몫. +- 불러오기 미리 보기 호표(`Hopyo_View` 읽기 전용 표 · `Hopyo_Build.py:155 · 332`)에서 M01 로직 줄이 생기는 갈래가 있는지 — 857 몫으로 남김(있으면 856-1 의 안내 띠가 거기서도 뜸). +- 프로젝트 층(M02 페이지 `layer=project`) 일위대가가 실제로 쓰이는지 · 프로젝트 층 SK 서고 권한 — 856-3 앞에 확인. +- `M02_Sk_AutoRenew` 알림이 머리 띠 「M01 개정」 을 모두 대신하는지(둘째 기초 `revisedAdds` 포함) — 856-2 에서 견본으로. +- 자릿수 규정은 건설 · 산림 1 장 · 건설 8 장만 읽음(장마다 「[주] 소수」 규정이 따로 있을 수 있음 — 1-2-2 ② 「항목에서 제시한 자리 우선」). + +### 7-3 세기 결과(`tmp/s894/m856/`) + +| 도구 | 결과 | 핵심 수 | +| --- | --- | --- | +| `census_rows.py` | `out_rows.json` | SC 6 · 줄 28 = SK 참조 11 · SC 참조 2 · 고정 15 · 로직 0 · 패치 · 입력값 · 고름 · 자재표시 0 / SK 14 몸 칸 값 0 | +| `census_imports.py` | `out_imports.tsv` | 걷을 화면 파일 17 · 부르는 TS · 이름 부르는 시험 | +| `census_server.py` | `out_server.tsv` | 몸 칸을 읽는 서버 py 26 파일 269 자리(B09 「덮개」 다른 뜻 4 파일 포함) | +| `census_places.py` | `out_places.json` | 표 소수 25,726 중 끝 0 남은 것 4,775 · 끝 0 없는 표 파일 25 / 83 | diff --git a/docs/raw/요구_1104/설계_857_불러오기한번읽기.md b/docs/raw/요구_1104/설계_857_불러오기한번읽기.md new file mode 100644 index 000000000..8756a5d7a --- /dev/null +++ b/docs/raw/요구_1104/설계_857_불러오기한번읽기.md @@ -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` | 둘 꼴 → `실무자료/산근/.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)은 그 뒤에도 느릴 때만 | +| 저장본 무효(`산근/.json` `재료판` · 무효 = HP 지움뿐 · `San_MatPick.py:194`) | **일부** — 3-2 둘째 박자 뒤에도 판은 그대로 남음 | 판에 **M01 지문 + 별칭 판 + 그 파일 고름 판**을 같이 적고 다르면 다시 셈(분석 C (나) 4 · 어림 10 줄) · 한 번 읽기(857-1)에서 `산근/.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` | 판 첫 셈 시간 · 이음 몫 · 프로파일 | diff --git a/resources/tester/test_719_2_sk_project.py b/resources/tester/test_719_2_sk_project.py index 741cc81ee..5593213fb 100644 --- a/resources/tester/test_719_2_sk_project.py +++ b/resources/tester/test_719_2_sk_project.py @@ -119,8 +119,8 @@ def test_SK_대가_블록_금액_M02_같음_하위_산근(world, tmp_path): def test_SK_단가_덮개_속_일위대가_펼침(world, tmp_path): - if not _engine_ready(world): - pytest.skip("715-1b 엔진 입력 덧칸(단가 · 값묶음) 뒤 — 지금은 M02 SK 셈도 못 함") + # 715-1b 엔진 입력 덧칸(단가 · 값묶음) — 못 세면 건너뛰지 않고 실패 + assert _engine_ready(world), "M02 SK 셈이 단가 덮개를 못 셈(715-1b 엔진 입력 덧칸)" key = _mine(world, full=True) # 740-1 — 속 일위대가 = 넣을 때 펼쳐 담음(SC 로직 줄 = 로직 더한줄 · 본뜬) → 빠진 줄 없음 live = _calc(world["personal"], key)