From 648bce0917fb5826e013b9a8a4608c3f6c5e5006 Mon Sep 17 00:00:00 2001 From: umsangdon Date: Mon, 16 Nov 2026 18:02:37 +0900 Subject: [PATCH] =?UTF-8?q?chore(ledger):=20=EC=A1=B0=EC=82=AC=20889a=20?= =?UTF-8?q?=E2=80=94=20=EA=B2=B9=EC=B3=90=20=EB=8D=AE=EB=8A=94=20=EC=B8=B5?= =?UTF-8?q?=20=C2=B7=20=EC=B9=B8=20=EB=8B=A8=EC=9C=84=20=EA=B0=B1=EC=8B=A0?= =?UTF-8?q?=20=C2=B7=20=EA=B8=B0=EA=B3=84=20=ED=95=9C=20=EB=8C=80=20?= =?UTF-8?q?=ED=95=9C=20=EC=A4=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- .../요구_1104/_조사_889a_겹층_갱신_기계줄.md | 479 ++++++++++++++++++ 1 file changed, 479 insertions(+) create mode 100644 docs/raw/요구_1104/_조사_889a_겹층_갱신_기계줄.md diff --git a/docs/raw/요구_1104/_조사_889a_겹층_갱신_기계줄.md b/docs/raw/요구_1104/_조사_889a_겹층_갱신_기계줄.md new file mode 100644 index 000000000..e151f08c5 --- /dev/null +++ b/docs/raw/요구_1104/_조사_889a_겹층_갱신_기계줄.md @@ -0,0 +1,479 @@ +# 조사 889a — 겹쳐 덮는 층 · 칸 단위 갱신 · 기계 한 대 한 줄 + +범위 = 읽기 전용 조사(제품 코드 · 마스터 자료 안 고침 · git 읽기만 · 화면 조작 없음). 측정 스크립트 · 목록 = `tmp/brain_889/`. 표기 = **[사실]** 파일 · 줄 번호로 확인 · **[짐작]** 읽고 미루어 봄 · **[실측]** 이 조사에서 계산기를 돌려 얻음. +경로 약칭 = `M02/` = `M02_MasterTemplete/` · `scripts/` = `resources/master_data/scripts/` · `A00/` = `A00_Common/` · `cu/` = `common_util/`. + +## 0. 한눈에 + +| 번호 | 결론 | 근거 절 | +| --- | --- | --- | +| 1 | 계산기(파이썬 · TS 짝)는 문서 칸 `기계덮음` 을 **어느 문서에서든** 읽음 — SK 전용 가정 없음. 막힌 곳 = M01 저장 길(`prune_doc` · `clean` 없음) · 화면(`readOnly` 켜짐) · **빌더(저장 폴더를 통째 덮어씀)** | B | +| 2 | 빌더 `build_수식문서_802_2.py` 는 저장본의 사람 편집을 이어받는 장치가 **없음** — 화면에서 저장한 M01 수식 문서는 빌더를 다시 돌리면 사라짐. 지금 저장본 = 빌더 결과와 같음(`--check` 같음) → 살아남은 화면 편집 0건 | B | +| 3 | 덮음은 **맨 위 문서 하나**의 칸만 읽힘(부르는 문서의 덮음은 무시) → 「기초 A 가 기초 B 를 부름」 에서 덮음은 **보고 있는 A** 에만 걸림 | B6 | +| 4 | SK 는 기초의 덮음을 따로 담을 칸이 없음. 파생 길(`derive`)은 기초 문서째 복사라 기초 덮음이 SK 문서에 **섞여 들어옴**, 그 뒤 `carry` 가 사용자 덮음으로 **통째 갈음**(합치지 않음) | C | +| 5 | 갱신 판정 지문이 **문서 통째 지문**(기계덮음 포함) · **기계 줄 통째 지문**(이름 · 출처 · 비고 포함) → 칸 단위가 아님. 기초 덮음만 바뀌어도 SK 의 따로 문서 · 끊음이 지워질 길이 열림 | D | +| 6 | 「위 층과 같게」 를 지금 단추로 만들 수 없음 — 칸 [원래 값] 의 기준(`base`)이 **덮음 없는 기계 식 답** 하나뿐 · [M01 값으로] 는 옛 칸만 걷고 수식 칸(문서 · 기계덮음)은 못 걷음 · [재생성] 은 프로젝트 층에서만 그려짐 | E | +| 7 | 부품 「입력 · 고르기」 에 「바뀜」 상태 속성이 없음. 쓸 만한 색 값 = `--color-info`(파랑) · `--color-warning`(주황) — 밝음 · 어두움 값 모두 있음. `--color-accent` 는 포커스 링과 같은 값이라 부적합. 기초에서 고친 자리의 바탕 값은 제어 구역 밖에서는 화면이 모름 | F | +| 8 | M01 기계 「쓰는 곳」 은 옛 로직 JSON 의 기계 고르기 · EQ 키 글자 · SK 파일 글자 검색만 셈 → 수식 문서가 쓰는 곳을 크게 덜 셈(굴착기 0.2㎥ 11 대 68 · 집게 0.2㎥ 1 대 26) | G | +| 9 | 기계 둘 한 줄 = **조합 식 줄 75 개(32 + 43) · 문서 67 장** + 단가 식이 두 기계를 직접 더하는 줄 5 개(+ 한 대가 EQ 둘을 읽는 1 개) · 로직 길(수식 문서 없음)에 남은 기초 0 | H | +| 10 | 216 짝(굴착기 × 부착 기계 × 보정작업) 실제 셈: 「굴착기 단독 식 + 부착 손료만 식(GC000273)」 합이 조합 식과 **재료비만 다름 216/216**(잡재료율 21 · 22 % 대 조합 16 %). 굴착기 줄에 **잡품 율 16 % 덮음**을 얹으면 **216/216 노 · 재 · 경 같음**. 문서 단위(67 장)로 가르면 59 장 같음 · 2 장 1 원(줄 끝수) · 6 장 −23 ~ −52 원(식이 조합 값을 다시 씀) | I | +| 11 | 지금 엔진은 조합 줄의 시간당 작업량을 **부착 기계 쪽 열쇠**로 찾아 「시간당 작업량 식 없는 기계」 로 **멈춤**(실제 셈 확인). 나눈 두 줄이 같은 작업량을 쓰려면 엔진(파이썬 + TS 짝)에 「부착 줄이 굴착기 줄을 따름」 규칙 추가 필요 | I | +| 12 | storage 실제 SK = 5 건(전부 개인 층) · 기계덮음 0 · 따로 0 · 프로젝트 B09 수식.json 0 → 옛 저장본 옮김 부담 없음 | J | + +--- + +## A. 값 흐름 지도 + +### A1. 층마다 「그때그때 위를 읽음」 인가 「복사해 박음」 인가 + +| 층 | 기계 값을 어디서 얻나 | 방식 | 근거 | +| --- | --- | --- | --- | +| M01 기계 정본 | `resources/master_data/기계/EQ######.json` 한 대 한 파일(655 대). 값 칸 = 가격 · 계수 · 주연료 · `인력[]` · `잡품[]` · `작업량[]` | 정본 | [사실] 파일 확인 · `M01_MasterData_Machine.py:25` | +| M01 기초 계산(서버) | 기초 → 기계 식 부름(`sub`) → 변수 연결 `요소 {키 EQ:{S_기계}, 칸}` → `Links.element` → `mm.element` → `master.value` | **그때그때**(저장본 없음 · 같은 계산 안에서만 `memo`). 마스터 색인은 파일 자국이 바뀌면 다시 읽음 | [사실] `scripts/master_doc_calc.py:218-320` · `scripts/master_doc_link.py:145-177` · `M01_MasterData_Store_Cache.py:1-14` | +| M01 기초 화면 | 서버 `_run` 이 셈하며 쓴 요소 값 · 표 · 부름 문서를 `Rec` 에 적어 실어 보냄 → 브라우저가 같은 계산기로 즉시 셈 | **복사**(그 화면 동안의 캐시) · 캐시에 없는 연결만 뒤에서 서버 | [사실] `scripts/master_doc_record.py:1-30` · `M01_MasterData_Doc.py:59-67` | +| M02 SK 만들기 | `skc.stamp/snap` = 기초가 닿는 **줄 통째**(`수식.로직` 옛 로직 줄 · `수식.단가` EQ · 노임 · 자재 줄) + 닫힌 묶음 문서(`수식.부름`) + 지문(`판` · `단가판`) + `원본 {키, 판}`. 파생 길의 `수식.문서` 는 저장 안 하고 셈마다 지음 | **복사**(사본 줄 · 부름 문서) · 문서 본체는 파생 = 그때그때 | [사실] `M02/M02_Sangeun_Copy.py:168-200` · `M02/M02_Doc_Sk.py:75-99, 115-144` | +| M02 열기 · 미리 셈 · 셈 | 프로젝트 층 밖이면 `renew.rows` 가 사본 줄을 **지금 M01(+ 내 기계)** 줄로 갈음해 셈 · `renew.form` 이 부름 문서도 지금 M01 문서로. 파일은 안 씀 | **그때그때 위를 읽음**(저장 전까지 파일은 옛 사본) | [사실] `M02/M02_Sk_AutoRenew.py:1-15, 57-87, 136-176` · `M02/M02_Sangeun_Copy.py:129-150` | +| M02 [저장] | `skc.settle(save)` 가 갈음한 줄을 파일에 굳힘 → `M02_Copy_Slim` 이 **셈이 읽은 줄만** 남김(고른 기계 줄만) → `M02_Doc_Gap.fill` 이 빈틈을 지금 값으로 박음 | **복사해 박음**(고른 기계 줄만) | [사실] `M02/M02_Sangeun_Copy.py:286-306` · `M02/M02_Copy_Slim.py:1-12` · `M02/M02_Doc_Gap.py:1-9` | +| M02 알림 [확인] | `갱신확인` 저장 = 알림 내용 굳힘 | 복사 | [사실] `A00/line_stack_screen.ts:566-568` | +| 프로젝트 굳히기 | `Item_Source.build_source` → `M02_Item_Sangeun.freeze` 가 SK 를 풀어 `GX9#####` 굳힌 줄로 박고 **`수식` 칸(기계덮음 포함)을 문서째 복사**. `M02_Doc_B09.attach` 가 사본 옆 `수식.json`(닫힌 문서 묶음)을 더함 | **복사**(프로젝트 층 = 사용자가 [단가 갱신] · [재생성] 으로 고름) | [사실] `M02/M02_Item_Sangeun.py:45-93(88-89)` · `M02/M02_Doc_B09.py:34-53` · `B09_Estimation/B09_Estimation_Bill_Library.py:245` | +| B09 | 프로젝트 사본의 SK 블록 = **M02 SK 셈 그대로**(`sk_money`) — 사본 줄 · 수식 사본 위에서 계산 · B09 자체 기계 셈 없음(시험이 글자로 막음) | 복사 값 그대로 읽음 | [사실] `B09_Estimation/B09_Estimation_Labor_Source.py:231` · `B09_Estimation_Calc_Labor.py:261` · `resources/tester/test_841_1_b09_m02_values.py:1-12` | + +### A2. 기계 값 한 칸(굴착기 1.0㎥ 가격)의 길 + +1. M01 `기계/EQ000022.json` `값.가격` 정본. +2. 기초 GC000267 변수 `P_기계`(`요소 EQ:{S_기계} 칸 가격`)가 **셈 때** 읽음 — 기초 문서에는 가격이 없음. +3. SK 를 처음 저장하면 사본 `수식.단가` 에 그 기계 줄 통째가 박힘(고른 기계 줄만 · `Copy_Slim`). +4. 열 때마다 `renew.rows` 가 사본 줄을 지금 M01 줄로 갈음 → 금액이 M01 따라 바뀜(저장 안 해도). +5. [저장] 때 갈음한 줄이 파일에 굳음 → 「복사 당시 값」 은 저장 시점마다 **덮임**. +6. 프로젝트 사본을 만들면 그 시점 값이 `수식` 째 얼어붙음 → B09 가 그 위에서 셈. + +### A3. 짐작 · 빈칸 + +- [짐작] 「복사 당시 위 층 값」 이 필요하면 4 → 5 에서 갈음 직전 줄이 곧 바탕임(지금 `_covers` 가 `got` 대 `out` 으로 그렇게 씀 · `M02_Sk_AutoRenew.py:222`). +- 못 한 것: 화면(브라우저)에서의 실제 캐시 내용 대조 — 코드 읽기만. + +**추천(A)**: 새 구조에서도 SK 의 「기계 줄 사본」 을 **바탕 저장소**로 계속 쓰되, 갈음 직전 줄과의 칸별 대조 결과를 알림에 남기는 쪽이 새 칸 없이 가능. + +--- + +## B. 기초에 고침 그릇을 둘 수 있나 + +### B1. 계산기 짝이 M01 문서에서도 `기계덮음` 을 읽는가 — 읽음 + +| 자리 | 사실 | 근거 | +| --- | --- | --- | +| 파이썬 계산기 | `calc(doc, …, cover=None)` → `cover_of(doc)` = **그 문서의 칸 `기계덮음`**. 부름(`sub`)마다 `cover_doc(doc, given, self.cover, base)` 로 얹음 · 하위 `calc` 에 같은 `self.cover` 전달 | `scripts/master_doc_calc.py:290-320, 526-533` | +| TS 계산기 | `calcDoc(…, cover?)` → `cover ?? machineCover(doc)` · 부름마다 `coverDoc(...)` | `cu/common_util_formula_doc_calc.ts:149, 379-382, 598-601` | +| M01 화면 미리 셈 | `mc.calc(doc, rec, given)` — 덮음 인자 없음 = 문서 칸을 씀 | `M01_MasterData/M01_MasterData_Doc.py:59-67` | +| 검사 | `md.check` 는 모르는 문서 칸을 막지 않음 · M01 `_check` 는 꼴 · 키 · 목록만 | `scripts/master_doc.py:419-470` · `M01_MasterData_Doc.py:70-78` | +| 화면 제어 구역 | M01 기초 = `readOnly: !h.machine?.scope` → `scope` 는 M02 사본(`cp`)에만 있음 → **M01 은 잠김** | `A00/line_stack_edit.ts:554` · `A00/line_stack_screen.ts:290-296` | + +→ 계산 쪽 막힘 0. 막힘 = **저장 길**(아래 B2) · **화면 잠금** · **빌더**(B3). + +### B2. M01 기초를 시스템 관리자가 고쳐 저장하는 길 + +| 항목 | 사실 | 근거 | +| --- | --- | --- | +| 화면 | M01 로직 연구실 [저장] = 로직 줄(`/save` · 기본정보 · 별칭) **+** 수식(`/logic/doc/save`) 한 번에 · [되돌림] = 둘 다 | `M01_MasterData/M01_MasterData_UI_LogicLab.ts:8-9, 158, 322, 339` | +| API | `GET /logic/doc` · `POST /logic/doc/preview` · `POST /logic/doc/save` · `POST /logic/doc/links` · `GET /logic/doc/table` | `M01_MasterData_Router.py:437-489` | +| 권한 | M01 라우터 전체 `system_admin_only` | `main.py:550-553` | +| 저장 동작 | `save(doc)` = `_check`(꼴 · 키 · 목록) → 해당 `수식_<꼬리>.json` 에 줄 갈음 · `ml.dump` 로 씀. **판 · 409 · 개정확인 없음**(개정확인은 로직 줄 `/save` 몫) | `M01_MasterData_Doc.py:106-120` · `M01_MasterData_Store_Revise.py:1-12` | +| 덮음 검사 | **없음** — M02 길(`M02_Doc_Sk_Path.edited` 가 `mcv.clean` + `mcv.prune_doc` 호출)에만 있음 | `M02/M02_Doc_Sk_Path.py:156-168` | +| `check_master` | 수식 문서 · `master_doc` 를 안 봄(검색 0건) | `scripts/check_master.py`(grep) | + +### B3. 빌더가 다시 지을 때 그 고침이 지워지는가 — **지워짐** + +| 사실 | 근거 | +| --- | --- | +| 빌더는 옛 로직 JSON + 변환 규칙(`master_doc_convert` · `master_doc_unit`)에서 문서 1,520 을 **전부 새로 지음**(`cv.convert(whole, row)`) | `build_수식문서_802_2.py:120-131` | +| 쓰기 = `files_of(result)` 가 파일마다 새 글을 만들고 `main()` 이 **저장 폴더 파일을 통째 덮어씀 · 남는 파일은 `unlink`** | `build_수식문서_802_2.py:228-235, 332-345` | +| 저장본의 사람 편집을 읽어 이어받는 코드 **없음**. 읽는 건 `lost()`(저장본에 있는데 이번에 저장 밖인 **키** 경고) 뿐 | `build_수식문서_802_2.py:210-225` | +| `--check` 는 저장 글이 빌더 글과 다르면 「다른 파일」 → 화면 편집이 있으면 이 시험이 깨짐 | `build_수식문서_802_2.py:305-318` · 시험 `test_802_2_convert.py:33` | +| 틀 문서가 못박음: 「옛 로직 JSON 과 따로 — **빌더만 씀**」 | `resources/master_data/_수식문서_틀.md:16` | + +### B4. 지금까지 관리자가 화면에서 고친 수식 문서는 어떻게 살아남았나 — **살아남은 것 없음** + +- [실측] `build_수식문서_802_2.py --check` = 「같음」(변환 1,520 · 저장 1,520 · 옵션 표본 18,873 · 옵션 다름 3(채택) · 둘 다 못 셈 175) → 저장 폴더 = 빌더 결과 그대로. `tmp/brain_889/_build_check.txt`. +- [실측] 문서 1,520 장 어디에도 문서 칸 `쌓기` · `기계덮음` 없음(스캔). +- [사실] `수식문서/` 를 건드린 커밋 19 개 전부 빌더 · 변환 규칙 · 로직 JSON 고침과 한 묶음(단위 채움 845-1 · 845-3 · 847-2 는 커밋 글이 「변환 끝」 규칙으로 밝힘 — 짐작: 빌더 `master_doc_unit` 결과) — 화면 저장만으로 문서 파일이 바뀐 커밋 흔적 못 찾음. 검증 기록(802-3 · 804-7)도 저장 뒤 「정본 되돌림 같음」. +- 결론: 지금까지 「관리자가 화면에서 고친 문서」 가 쌓인 적 없음 → **이어받는 장치가 없어도 문제가 드러난 적 없음**. 새 구조가 처음 이 문제를 만듦. 일반 문서 편집(덮음 아닌 것)도 같은 위험 — 범위 밖이나 같은 자리에서 한 번에 해결됨. + +### B5. 지워진다면 이어받게 할 가장 작은 자리 + +| 안 | 고치는 곳 | 크기(짐작) | 장단 | +| --- | --- | --- | --- | +| α. 빌더가 이어받음 | `build_수식문서_802_2.py` 의 `files_of`(또는 `build` 끝)에서 저장본 `기계덮음` 을 키별로 읽어 새 문서에 그대로 얹음 · `--check` 도 `files_of` 를 쓰므로 한 곳 · + M01 `save` 에 `mcv.prune_doc` 호출 | 빌더 십수 줄 + M01 save 몇 줄 | 한 파일 truth(덮음이 문서 안) · 계산기 · 화면 변경 없음 · 일반 편집은 그대로 못 이어받음 | +| β. 덮음만 곁 파일에 둠 | `수식문서/` 밖(예 `수식문서_고침/`)에 `{키: 기계덮음}` · `ml.load_all`(한 곳)이 읽어 문서에 합침 · M01 `save` 가 덮음을 곁 파일로 갈라 씀 · `drop/remove` 가 곁 항목 지움 | `load_all` + M01 save · drop | 빌더 · `--check` 손 안 댐 · 두 파일 truth · `load_all` 이 `수식_*.json` 글롭이라 이름 겹침 주의 | + +- `ml.load_all` 호출자 = `Links` 기본 · `dc.folder()` · `M01_MasterData_Doc.docs()` 세 곳(합침 한 곳으로 충분). [사실] `scripts/master_doc_link.py:121-122, 199-205` · `M02/M02_Doc_Copy.py:63-69` · `M01_MasterData_Doc.py:39-44`. +- **추천(B)**: 안 α. 이유 = 덮음이 문서 안에 있어야 `prune_doc` · SK 복사(`derive` 가 문서째 복사) · 화면 · 시험이 지금 꼴 그대로 돎. + +### B6. 부름 사슬에서 덮음이 어느 문서에 걸리나 — **맨 위 문서 하나** + +- [사실] `calc(..., cover=None)` 은 **맨 위 문서**의 `기계덮음` 만 정함(`scripts/master_doc_calc.py:533`) · 부름 문서의 `기계덮음` 은 읽지 않음(하위 `calc` 에 `self.cover` 를 넘김 · 305-307). 열쇠 = 기계 입력 글(원문번호) · 847-1 작업량 덮음은 줄 단가 기호. +- [사실] 기초 A 가 기초 B 를 부를 때: A 를 열어 고친 덮음 → A 셈의 **모든 깊이의 같은 기계**에 적용(B 안 기계 줄도). B 를 따로 열어 고친 덮음 → B 가 **맨 위일 때만** 효력. A → B 부름에서 B 문서에 실린 덮음은 무시됨. +- [실측] 시간당 덮음 시험: GC001070 에 `{0201-0020: 작업량 시간당}` → 셈 같음(조합 줄은 부착 기계가 일하는 기계) · `{7206-0020: …}` → 「시간당 작업량 식 없는 기계」 멈춤. `tmp/brain_889/_work_probe.py`. +- 함의: 「지금 보고 있는 이것만」 이 계산 규칙과 이미 맞음. 단 화면 제어 구역은 **그 문서 금액 줄에 있는 기계**만 그림 — 부름 안쪽 기계 줄은 산출근거에서 펼쳐 보일 뿐 제어 구역이 없음. + +--- + +## C. 기초 고침 → SK 로 내려가는 길 + +### C1. 지금 구조(사실) + +| 칸 | 담는 것 | 근거 | +| --- | --- | --- | +| `수식.로직` · `수식.단가` | 값 층 — M01 줄 사본(EQ 줄 통째) | `M02/M02_Doc_Copy.py:122-125` | +| `수식.부름` | 부르는 단가산출 닫힌 묶음의 M01 문서 사본(그 안 `기계덮음` 도 그대로 실리나 **셈에서 안 읽힘**) | `M02/M02_Doc_Copy.py:106-118` | +| `수식.문서` | 이 SK 문서. **파생** = 저장 안 하고 셈마다 `derive` 로 지음(바탕 M01 문서가 사본 줄과 같으면 `copy.deepcopy(live)` = **기초 덮음 포함**). **따로** = 저장본 | `M02/M02_Doc_Sk.py:75-99` · `M02/M02_Doc_Copy.py:77-91` | +| `수식.원본 {키, 판}` | 이 SK 를 찍은 M01 문서와 그 **통째 지문** | `M02/M02_Doc_Sk.py:142-143` | +| `수식.처음` | 따로가 된 **그때 문서**(고침 판정 원본 · 없으면 「옛 저장본」) | `M02/M02_Doc_Sk_Path.py:171-172` | +| `수식.문서.기계덮음` | 사용자 덮음(열쇠 = 기계 원문번호 · 원본과 같은 칸은 `prune` 로 지움) | `scripts/master_doc_cover.py:195-210` | + +### C2. 「기초에서 고친 것」 과 「내가 고친 것」 을 가를 수 있는가 — **지금은 못 가름** + +- 파생 길: 기초 문서를 복사할 때 기초 덮음이 `문서.기계덮음` 에 **섞여 들어옴**(`derive` · `M02_Doc_Sk.py:90-91`). 그 뒤 `renew.carry(got, root)` 가 `got[COVER]` 가 있으면 **`{**root, COVER: got[COVER]}` 로 통째 갈음**(합치지 않음 · `M02_Sk_AutoRenew.py:245-247`) → 기초 덮음 + 내 덮음이 합쳐지지 않고 내 것만 남음. +- 따로 길: 저장된 `문서` 안에 기초 덮음 · 내 덮음이 구분 없이 한 칸. +- 같은 값 문제: `prune` 은 「원본과 같은 칸 지움」 이라 내가 기초 값과 같은 수로 되돌리면 내 흔적 소멸 — 층 모델과 일치(각 층은 자기가 바꾼 칸만). + +| 후보 | 담는 꼴 | 셈 | 장 | 단 | +| --- | --- | --- | --- | --- | +| ① 두 칸 | SK `수식.기초덮음`(복사 당시 기초의 `기계덮음` 그대로) + `수식.문서.기계덮음`(내 것만 · 기초와 같은 칸은 지움) | `mcv.merge`(이미 있음 · 값 = 칸별 · 조종원 · 잡품 = 목록 통째 · `scripts/master_doc_cover.py:356-364`)로 두 층을 합쳐 계산기 `cover` 인자(이미 있음)에 넘김 | 층이 칸으로 갈림 · 기초 새 판과 칸별 대조 쉬움 · 계산기 본체 변경 없음 | 파생 길 `derive` 가 기초 덮음을 문서에 복사하는 것을 끊어야 함(`carry` 규칙 교체) · 셈 호출부 5 곳(서버 `M02_Doc_Copy.run` `:142-147` · `M02_Doc_Gap.py:55` · `M02_Doc_Screen.py:35` · TS `A00/line_stack_screen.ts:197` · `line_stack_out.ts:221`)에 합친 `cover` 넘김 필요 | +| ② 합침 + 바탕 | `문서.기계덮음` = 합친 것 · 따로 `수식.덮음바탕` = 복사 당시 기초 덮음 | 합친 것이 곧 실효 → 셈 · 화면 그대로 | 셈 변경 없음 | 「내 것」 = 합침 − 바탕 을 매번 계산 · 기초가 바뀔 때 합친 것을 다시 짜야 함 · 내 칸이 기초와 우연히 같으면 구분 못 함 | +| ③ 층 목록 | `덮음층: [{층: 기초, …}, {층: 나, …}]` | 위 순서로 합침 | 층이 셋 이상(회사 · 개인)으로 늘어도 같은 꼴 | 새 꼴 · 시험 · 화면 전부 새로 | + +- 파이썬 · TS 짝 변경 범위(① 기준): `scripts/master_doc_cover.py` ↔ `cu/common_util_formula_doc_cover.ts`(merge · prune 의 `base` 인자) · `scripts/master_doc_calc.py` ↔ `cu/common_util_formula_doc_calc.ts` 는 이미 `cover` 인자가 있어 **본체 무변경**. 거울 시험 `test_836_1_machine_cover.py` · `test_846_1_machine_work.py` · `test_842_3_machine_crew.py` 가 같이 움직임. +- **추천(C)**: 안 ①. + +### C3. SK 가 SK 를 부르지 않는지 + +- [사실] 기초에서 만든 SK(파생 · 따로) = 부름은 M01 수식 문서뿐(`dc.calls` = 변수 `단가산출` 키 + 시간당 식 · `M02/M02_Doc_Copy.py:94-103`). 복사 줄(`M02_Doc_Take`)은 조각을 **복사**해 펼침. +- [사실] **예외 = 가져온 식 SK(엑셀 불러오기)**: 변수 연결 `{키: SK-…, 참조 {층, 주인}}` 로 **형제 SK 를 부름**(`M02/M02_Doc_Import.py:9-13, 509-553`) — 부르는 쪽 단가기준으로 · 안쪽 SK 파일을 `refs.read_ref` 로 지금 읽음. 이때도 덮음은 맨 위 문서 것만 읽힘(B6). +- [실측] 실제 storage 5 SK 에 `SK-` 부름 0. + +### C4. 일위대가 · 구조물 조합은 SK 값을 읽기만 하는가 + +- [사실] `기계덮음` 을 다루는 파일 = `master_doc_cover` · `master_doc_work` · `M02_Sk_AutoRenew` · `M02_Sangeun_Copy`(재생성이 지움) · `M02_Item_Sangeun`(프로젝트 복사) · `M02_MyMachine*` 뿐 — 일위대가(SC) · 구조물 조합 쪽 `M02_Labor_*` 에 덮음 코드 0건(grep). +- [짐작] SC · 구조물 조합은 SK 금액을 `on_run` 이 단 `기준 · 1단위 · 수식셈` 으로 읽는 길(`M02/M02_Doc_Sk.py:147-160`) → 읽기만. 줄 패치(덮개 · 뺀줄 · 더한줄)는 옛 칸 꼴. + +**추천(C 전체)**: 안 ① + 갱신·판정 지문에서 `기계덮음` 제외(D4). + +--- + +## D. 칸 단위 갱신 + +지금 판정 · 지움 전수 표 = `tmp/brain_889/_목록_갱신_판정.tsv`. 요약: + +| 대상 | 지문 | 바뀌면 | +| --- | --- | --- | +| 값 줄(`수식.로직`/`단가`) | 줄 통째 `_fp`(이름 · 출처 · 비고 · 단위 포함) | 줄을 지금 M01 줄로 갈음(조용히) | +| 부름 문서 | 문서 통째 `dc.fp` | 지금 M01 문서로 갈음 · 그 키의 `끊음` 이 LOGIC(변수 · 식 · 금액 · 끝수 · 결과단위)이 다르면 끊음 삭제 + 알림 `부름` | +| 따로 문서 | M01 문서 통째 지문 ≠ `원본.판` | `따로 · 문서 · 처음` 삭제(파생으로) · 사용자 고침이 `처음` 과 LOGIC 이 다르면 알림 `문서` · 기계덮음만 맡겨 둠 | +| 기계덮음 | **기계 줄 통째 지문**(사본 줄 대 지금 줄) | **그 기계 덮음 항목 통째 삭제** + 알림 `기계`(M01 = 값 칸만 전 → 후 · 내고침 = 칸 · 조종원 · 잡품 글) | +| 프로젝트 층 · B09 | `on()` 거짓 | 안 함 | + +### D1. 칸 단위로 바꾸려면 필요한 것 + +| 필요 | 지금 | 판정 | +| --- | --- | --- | +| 복사 당시 위 층 값(바탕) | 사본 `단가` 의 EQ 줄 통째가 마지막 저장 시점 값 = 바탕 · 갈음 직전에 `got` 대 `out` 로 대조 가능(`_eq_rows` · `M02_Sk_AutoRenew.py:180-188, 222-225`). **단 `Copy_Slim` 이 고른 기계 줄만 남김** → 고르지 않은 기계는 바탕 없음(고르는 순간 지금 값이 바탕이 됨) | 가능(고른 기계 한정) · 저장 시점마다 바탕이 지금 값으로 덮임 → 「알림 확인」 전까지 바탕을 따로 남겨야 함 | +| 칸 열쇠 | 덮음 `값` = 칸 이름 열쇠 → 칸별 대조 쉬움. 작업량 `{방식, 식, 변수{열쇠}}` = 변수 열쇠 칸. 조종원 · 잡품 = **목록 통째**(`prune` 도 목록 통째 비교) | 값 · 작업량 변수 = 칸 단위 · 목록 = 아래 D2 | +| 지문 | 줄 통째 → **칸 비교**(바탕 줄 대 지금 줄의 `값.<칸>`)로 교체 | 새로 짬 | + +### D2. 목록 꼴(인력 · 잡품 · 작업량)을 칸으로 맞대는 법 + +- 조종원 줄 `{키 LB:직종, 인, 이름?}` · 잡품 줄 `{줄 | 키, 이름?, 수량?, 율}`(`scripts/master_machine_crew.py:1-20`). 줄에는 **자연 열쇠**가 있음: 조종원 = 직종 키 · 잡품 = `줄`(식 재료 줄 이름) 또는 `키`(재료). +- 안 a(권장): **목록 통째 한 칸**으로 취급 — 바탕 목록 대 지금 목록이 같으면 안 바뀜 · 다르고 내 덮음이 있으면 「내 목록 유지 + 알림(바탕 전 → 후 글)」. 지금 `prune` · 화면 [원래 값] 이 이미 목록 통째 단위라 일치. +- 안 b: 자연 열쇠로 줄 단위 맞댐 — 직종을 바꿔 끼운 줄은 「삭제 + 추가」 로 보여 판정이 거칠어짐. +- 작업량 `{방식, 식, 변수}` = `방식` · `식` · 변수 열쇠별 3 갈래 칸. 단 **작업량 열쇠는 단가 기호**일 수 있음(847-1 · `scripts/master_doc_work.py:335-338`). + +### D3. 「계산 구조가 바뀜」 판정 — 지금 vs 필요 + +| 변화 | 지금 | 새 판정(제안 · 짐작) | +| --- | --- | --- | +| 기초 줄 더해짐 · 빠짐 · 식 글 바뀜 | 문서 통째 지문 ≠ → 갈음 · 고침(LOGIC 다름)이면 알림 + 고침 삭제 | **LOGIC 칸만** 비교(`_logic`) · 같으면 조용히 따라옴 | +| 기초 `기계덮음` 만 바뀜 | 지문에 섞여 문서 갈음 발동(따로 문서가 `처음` 과 같으면 조용히 파생으로 · 다르면 **내 문서 고침이 지워짐**) | 지문에서 `기계덮음` 제외 → 문서 갈음 안 일어남 · 덮음 층만 칸별 대조 | +| 기계 식 키 바뀜(예 GC000267 → 다른 식) | 부름 문서 지문 ≠ → 갈음 | 부름 키 · 입력 이름 집합이 바뀐 경우만 「구조 바뀜」 → 다시 복사 | +| 이름 · 출처 · 단위 글 | 지문에 포함 → 갈음(기계 줄은 **덮음 지움**) | 지문에서 제외(`LABEL` 류) · 기계 줄은 `값.<칸>` 비교 | +| 기계 줄 값 칸 변화 | 덮음 항목 통째 삭제 | 그 **칸만** 알림 · 내 칸 유지 | + +- [사실] 기계 줄 지문에 이름 · 규격 · 출처 · 비고가 모두 들어감(`skc._fp(prices.to_json(row))` · `M02_Sangeun_Copy.py:55-57`) → M01 기계의 **비고 · 출처 글만 바뀌어도** 그 기계 덮음이 지워지는 현재 규칙(`_covers` `:225`). +- [사실] `_same_new`(`:209-213`)는 옛 꼴 → 842-3 새 꼴 이행 때문에 둔 예외. + +### D4. 구조가 바뀌어 다시 복사할 때 덮음을 열쇠로 다시 얹을 수 있나 + +- 덮음 열쇠 = 기계 원문번호(글) → 기계가 그대로면 **얹힘**. 지금도 따로 문서를 지울 때 `keep = {COVER: mine[COVER]}` 로 맡겨 두고 `carry` 가 다시 얹음(`M02_Sk_AutoRenew.py:171-172, 245-247`). +- 못 얹는 경우: 기계를 다른 기계로 바꾼 줄 · 부르는 문서가 사라진 경우 → `prune_doc` 가 **안 부르는 기계 덮음을 빼 버림**(`scripts/master_doc_cover.py:446-447`). +- [사실] **주의 — 옵션으로 기계를 바꿔 저장하면 앞 기계 덮음이 사라짐**. 이유 = `prune_doc` 가 「이번 셈이 부른 기계」 만 남김. 시험이 이것을 못박음(`test_836_1_machine_cover.py:318-324` · 「안 부르는 기계 = 뺌」). 기초가 기계 9 대를 선택지로 두는데(GC000267) 관리자가 한 대 덮음을 고친 뒤 옵션을 바꿔 저장하면 앞 덮음이 사라지는 문제 → 층 모델의 「자기 칸은 자기 층이 가짐」 과 충돌. 해결 후보 = `prune_doc` 가 「선택 목록에 든 기계」 까지 남김. + +### D5. 알림(확인창)이 지금 싣는 내용 + +- 서버 알림 한 줄 `{키, 이름, 갈래(문서 · 부름 · 기계), M01 [전 → 후 글], 내고침 [글]}`(`M02_Sk_AutoRenew.py:250-257`) · 열 때 `notes(sk)` 가 `form` 을 한 번 더 돌려 **지울 것만** 모음(읽기 길은 파일 안 씀 `:260-266`). +- 화면 = 표 3 칸(항목 · 「M01 전 → 후」 · 「지워진 내 고침」) · [확인] = `갱신확인` 저장 · [나중에] = 다음에 또 뜸(`A00/formula_doc_renew.ts` 전체 · `A00/line_stack_screen.ts:566-568`). 뜨는 조건 = `cp && edit() && !dirty() && notes.length`. +- 새 방침(지키고 알림)에서는 「지워진 내 고침」 열이 「지킨 내 고침 + 바탕 전 → 후」 로 의미가 바뀜 · [확인] 의미(저장)는 같음. + +**추천(D)**: 판정을 「LOGIC 칸 + 기계 `값.<칸>`」 으로 좁히고, 기계덮음은 칸 단위 · 목록은 통째 · 기초덮음 변화는 문서 지문에서 제외. + +--- + +## E. 초기화 + +전수 표 = `tmp/brain_889/_목록_초기화_단추.tsv`(12 항목). 요약: + +| 단추 | 하는 일 | 단위 | +| --- | --- | --- | +| 칸 [원래 값](값 칸 · 작업량 변수 · 기계 보기 칸) | 그 칸 덮음 지움(`putCover` 가 원본 대조) | 칸 하나 · 캐시 | +| 묶음 [원래 값](조종원 · 잡품 · 작업량) | 그 목록 덮음 통째 지움 | 묶음 · 캐시 | +| [되돌리기](가져온 줄 「바꿈」) | 원래 줄로 | 줄 하나 · 캐시 | +| X 알림 되돌리기 | 직전 지움 복귀 | 한 번 · 캐시 | +| SK 머리 [단가 갱신] · [재생성] | 값 줄만 지금 M01 / 문서 · 끊음 · 따로 · 처음 · 기계덮음 지우고 다시 찍음 | SK 한 장 · 서버 · **프로젝트 층에서만 그려짐**(`copyTools` 가 `!mark.자동`) | +| 페이지 [M01 값으로] | 서버 `-reset` — 옛 칸(덮개 · 뺀줄 · 상수 · 표값 · 식덮개 · 더한줄 단가)만 걷음 | SK 한 장 · 서버 | +| 페이지 [되돌림](M02 · M01 기초 공통) | 저장 안 한 캐시 버림 · M01 은 로직 줄 + 수식 둘 다 | 화면 한 장 · 캐시 | + +- [사실] **[M01 값으로] 는 `수식` 칸(문서 · 끊음 · 기계덮음)을 안 건드림** — `reset` → `const.restore` 가 옛 칸만(`M02/M02_Library_Flat.py:528-535` · `M02/M02_Sangeun_Const.py:265-274`). 따로 SK 에서는 옛 칸 고침이 `M02_Doc_Sk.settle` 에서 409 로 막힘(`:197-203`). 코드 읽기 · **못 돌림**(임시 storage 필요). +- [사실] 프로젝트 층 밖(마스터 · 회사 · 개인)에는 [재생성] · [단가 갱신] 이 **안 그려짐** → 따로 문서 · 기계덮음을 한 번에 비우는 단추가 없음. + +### E1. 「위 층과 같게」 의 층별 정의 + +| 층 | 같게 = | 칸 [원래 값] 의 기준 `base` | 필요한 것 | +| --- | --- | --- | --- | +| 기초(M01) | **기계 정본 + 품셈 기본** = 덮음 없는 셈 | 지금 `defaultsOf(sub, 덮음 없이 셈한 답, rowEntry)` 가 이것 → **맞음** | 없음 | +| SK(M02) | **그 기초의 지금 상태(기초 덮음 포함)** | 지금 `base` 는 기초 덮음을 안 낌 → **틀림** | 화면 `calcSub`(`A00/line_stack_screen.ts:298-302` · 덮음 `{}` 로 셈)와 서버 `prune_doc`(`scripts/master_doc_cover.py:442-445` · 덮음 뺀 문서로 셈)가 **기초 덮음을 넣고** 기본값을 셈하게 | +| 내 기계(개인) | 정본 = 내 기계 줄 · 위 층 = M01 기계(복제 본뜬 기계의 `본뜬`) | — | 층 정의 필요(짐작) | + +### E2. 단위 + +- 칸 하나 · 기계 한 줄(그 기계 덮음 전체) · 문서 통째 — 앞 둘은 지금 단추가 있음(칸 · 묶음). **「기계 한 줄 통째」 와 「문서 통째 위 층과 같게」 단추 없음**(문서 통째 = 프로젝트 층의 [재생성] 만). +- [사실] 규칙 맞음: 칸 · 기계 · 묶음 단위는 **캐시 조작 → [저장]**(`putCover` · `h.change` 가 문서 고침 → 캐시 → `/save` 가 서버 정본으로 다시 셈)이라 지침 5장과 같음. 문서 통째 「위 층과 같게」 는 서버 쓰기(지금 [M01 값으로] · [재생성] 도 서버 직접 씀)가 현행 규칙과 일치 — 짐작으로는 두 단추를 합쳐 「위 층과 같게」 한 단추(미리 보기 → 확인 → 서버 씀)가 자연. + +**추천(E)**: 칸 · 묶음 · 기계 한 줄은 캐시 조작 · 문서 통째는 [M01 값으로](이름 유지)가 `기계덮음` · 따로 문서까지 걷도록 확대 + 프로젝트 밖에도 그림. + +--- + +## F. 바뀐 자리 표시 — 테두리 색 + +전수 표 = `tmp/brain_889/_목록_제어자리_테두리.tsv`(17 자리). 요약: + +| 구역 | 자리 | 부품 | 지금 알림 | 바탕 값을 그 자리에서 앎 | 상태 속성 | +| --- | --- | --- | --- | --- | --- | +| 위 옵션 가로 | 고르기 · 입력 칸 | `createSelectField` · `createInputField` (28) | 없음 | **모름** | 없음 | +| 왼쪽 공식 묶음 | 값 칸 · 고침 모드 3 칸 | `createInputField`(24) | 없음(표 값 직접 입력은 꼬리표 글) | **모름**(`before` 는 식 글만) | 없음 | +| 왼쪽 공식 묶음 | 표 값 칩 [표 · 칸 ▾] | `createButton`(ghost · clip) | 없음 | **모름**(원 조건 안 남김) | 없음 | +| 왼쪽 금액 줄 | 수량 칸 · 이름 칸 · 단가 식 · 단위 · 비목 · 항목 제목 · 글 줄 | input · select · UnitPick | 없음 | **모름** | 없음 | +| 왼쪽 금액 줄 | 이름 단추(기계 · 인력 · 재료 바꿈) | `createButton`(ghost link) | 가져온 줄만 「바꿈」 배지 + [되돌리기] · 기계 줄 머리 「고침」 배지(info) | 가져온 줄만 `바꿈.이름` | 없음 | +| 기계 제어 구역 | 값 칸 · 조종원 · 잡품 · 작업량 방식 · 식 · 변수 | input · select · segment · button | 「고침」 배지(info 18) + 풍선 「원래 값」 + [원래 값] | **앎**(`base` · `mine` · `was`) | 없음 | +| 기계 보기 | 값 칸 · 접이 카드 · 작업량 변수 | `createInputField/SelectField`(28) | 클래스 `is-changed` 토글 — **CSS 없음**(보이는 표시 0) | **앎**(처음 줄) | 훅(클래스)만 | +| 머리 | 배지 줄(고침 있음 · M01 새 판 · 새 값 · 지워짐 n · 사본 없는 줄 · 바꾼 줄 · 읽기만) | `createBadge` | 글 + 색 | — | — | + +- [사실] 입력 · 고르기 부품 상태 = hover · disabled · `.is-error` / `aria-invalid`(= `--color-danger` 선) · CSS 는 `[data-state]` 도 받음(hover 만 정의) → 「바뀜」 상태는 **부품 상자에 더해야** 함(CLAUDE.md 4장 「모자란 꼴은 부품 상자에 더함」). 근거 `ui_template/ui_template_input.css:36-49` · `ui_template_input.ts:8` · 단추 · segment CSS 도 상태 속성 없음(`ui_template_button.css:107-193` · `ui_template_segment.css:34`). +- [사실] 색 값(공통): `--color-info` #2e6fb5 / 어둠 #6aa6e0 · `--color-warning` #b45309 / #f5a524 · `--color-success` #1f8a4c / #3fbb6f · `--color-danger` #c0392b / #e8695a(오류 전용으로 쓰임) · `--color-accent` = `--color-focus-ring`(초록 · 포커스 선 · 고른 줄) — `ui_template/ui_template_theme.css:33-42, 71, 301-305, 335-339`. +- [사실] 지금 의미: `info` = 「고침」 배지(기계 제어 구역 · 가져온 「바꿈」) · `warning` = 표 줄 바뀜 막대(`.ui-table tr.is-changed`) · M01 그리드 노랑. +- **층 둘 가르기**: 색 두 개로 가를 수 있음 — 후보 = **내가 고침 = `--color-info`**(지금 「고침」 배지 색과 같아 의미 연속) · **기초에서 고침 = `--color-warning`** · (짐작) 색만 의존 말고 선 모양(실선 · 점선)으로 이중 표시하면 색 구분이 어려운 사용자에게 안전. 포커스 선(accent · 2px)이 입력 칸 테두리를 덮는 `:focus` 동안은 표시가 가려짐 — 입력 중에는 정상. +- [사실] 바탕을 모르는 자리가 대부분 → 층 둘 표시에는 서버가 **칸 경로별 「바탕 값 · 기초 값」 지도**(예 `사본.바탕`)를 실어 줘야 함. 제어 구역(기계 값)은 지금 자료로 충분. 화면 한 곳에서 칸마다 `data-diff="mine|base"` 를 달고 부품 CSS 가 테두리를 칠하는 구조가 최소(짐작). + +**추천(F)**: 1단계 = 부품 상자 「입력 · 고르기 · 단추 · segment」 에 `data-diff` 상태 + 제어 구역 · 기계 보기에 적용(자료 이미 있음) · 2단계 = 나머지 자리는 서버 바탕 지도 필요 → 별도. + +--- + +## G. 영향 목록 + +### G1. 지금 있는 것(사실) + +| 도구 | 무엇을 셈 | 근거 | +| --- | --- | --- | +| M01 기계 상세 「쓰는 곳」 `uses(key)` | ㉠ 옛 **로직 JSON** 줄의 입력 `기계` 고르기에 그 원문번호가 있음(`by_code`) ㉡ 로직 줄 글자에 EQ 키가 있음(`by_key`) ㉢ 모든 층 SK 파일에 글자 `"EQ…` 가 있음(`mark in raw`) | `M01_MasterData/M01_MasterData_Machine.py:186-230` | +| 내 기계 「쓰는 곳」 `uses()` | **이 층** SK 파일의 사본 · 수식 `단가` 줄에 그 내 기계 키가 있음 → `{키, 이름}` | `M02/M02_MyMachine.py:475-497` | +| 기초 「쓰는 곳」 `users(key)` | 다른 수식 문서의 단가산출 연결 · 일위대가 조합 · **SK `바탕.로직` 이 그 키** | `M01_MasterData/M01_MasterData_Doc.py:149-172` | +| M02 층 목록 요약 `M02_Layer_Index` | SK · SC **쓰는곳수**(그 SK 를 참조로 담은 파일 수) · 파생 저장본 | `M02/M02_Layer_Index.py:1-12, 176-181, 185-197` | + +→ 기계 → **수식 문서(기초)** 역색인 없음 · 기초 → SK 는 `바탕` 만(부름 사슬 · `수식.부름` 닫힌 묶음에 든 SK 누락) · 「그 칸을 따로 고쳐 둔 곳」 색인 없음 · 「금액이 바뀌는 곳」 없음. + +### G2. 실측 — 지금 「쓰는 곳」 이 덜 셈 + +`tmp/brain_889/_목록_기계_쓰임_수.tsv`(655 대). 수식 문서가 선택목록 · 입력값 · EQ 요소로 직접 쓰는 문서 수와 비교(대표): + +| 기계 | 현재 코드 로직 수 | 수식 문서 직접 | 호출 사슬 포함(상한) | +| --- | --- | --- | --- | +| 굴착기(무한궤도) 0.2㎥ EQ000017 | 11 | 68 | 293 | +| 굴착기(무한궤도) 0.6㎥ EQ000019 | 12 | 54 | 293 | +| 대형 브레이커 0.2㎥ EQ000031 | 2 | 9 | 134 | +| 부착용 집게 0.2㎥ EQ000436 | 1 | 26 | 132 | +| 크레인(타이어) 10ton EQ000128 | 4 | 106 | 349 | + +- 655 대 중 264 대에서 두 수가 다름 · 문서가 닿는 기계 621 코드(어느 문서도 안 쓰는 기계 13 대). +- 원인 [사실]: `by_code` 가 입력 이름 **`기계`** 만 봄 → 집게 · 브레이커처럼 이름이 다른 입력 · 기초 안에 박힌 `'0201-0020'` 글자 입력은 놓침. + +### G3. 영향 목록을 낼 수 있는 자료와 비용 + +| 항목 | 재료 | 비용(실측 · 짐작) | +| --- | --- | --- | +| 기계 → 기초 n | 수식 문서 1,520 장 스캔(선택 목록 · 입력값 · EQ 요소 · 호출 사슬) — 색인 한 번 | [실측] 색인 만들기 ≪ 1 초 · 호출 사슬은 상한(기본 선택 아니면 과대) | +| 기초 → SK(바탕 · 부름) | SK 파일 `수식.원본.키` · `수식.부름` 키 · 옛 `바탕.로직` | 지금 `users` 는 SK 파일 전부 읽음 · [실측] 기계 하나 `uses` **warm 0.046 s** · 655 대 전부 28 ~ 31 s(SK 5 건에서) | +| 그 칸을 따로 고쳐 둔 곳 k | SK 파일에서 `기계덮음` 열쇠(원문번호) 글자 검색 | [짐작] SK 수 × 파일 크기(5 건 총 약 105 KB) | +| 금액이 바뀌는 곳 | 영향 기초를 기본 옵션으로 다시 셈 | [실측] 문서 1,520 장 전부 다시 셈 **7.2 초**(장당 평균 4.8 ms) · 굴착기 0.6㎥ 한 대 가격 +10 % → 직접 54 장 · 호출 사슬 293 장 중 **기본 선택에서 실제 금액이 바뀐 문서 38 장**(1.15 초) · 0.2㎥ → 42 장 · 0.12㎥ → 8 장 | +| SK 금액 | SK 하나를 `read`(열기 + 셈) | [실측] 0.1 ~ 0.2 초/건(warm) — SK 수백 건이면 수십 초 → **색인으로 영향 SK 만 셈** 필요 | + +- 「쓰는 곳」 표시용으로는 위 색인으로 충분. 「금액이 바뀌는 곳」 은 사용자 옵션 선택에 달려 **기본 옵션 기준 + SK 는 그 SK 옵션 기준**으로 셈해야 하며 SK 수가 늘면 영구 저장본(`_derived`)에 문서 지문별로 두는 방식이 지침 5장 「파생 저장본」 과 맞음(짐작). + +**추천(G)**: `uses()` 를 **수식 문서 기준**(선택 목록 · 입력 · EQ 요소)으로 바꾸고 기초 → SK · 덮음 열쇠 색인을 SK 저장 시 같이 갱신하는 파생 저장본으로. + +--- + +## H. 기계 둘이 한 줄인 곳 전수 + +전수 목록 = `tmp/brain_889/_목록_기계둘_줄.tsv`(81 행 · 열 = 갈래 · 문서키 · 이름 · 묶음 제목 · 줄 이름 · 줄 규격 · 부르는 식 · 입력 · 수량 식 · 단가 식 · 줄 번호). 판정은 문서 1,520 장의 **모든 금액 줄**에서 단가 · 수량 식이 (식 줄을 따라) 닿는 기호를 풀어 단가산출 부름(기계 시간당 식 16 장) · EQ 요소를 센 것. + +| 갈래 | 수 | 내용 | +| --- | --- | --- | +| ㉠ 조합 식 부름 | 줄 **75**(GC000270 = **32** 줄 · 31 문서 / GC000271 = **43** 줄 · 37 문서) · 문서 **67** 장(두 식을 같이 쓰는 8 장 중복) | 입력에 기계 + `집게`(GC000270 · 3 종) 또는 `브레이커`(GC000271 · 6 종) | +| ㉡ 단가 식이 두 기계 값을 직접 더함 | 줄 **5** | GF000011 · GF000012 하베스터(EQ000634) + 굴착기(EQ000635) 「기계손료」 · GF000312 · GF000313 부착형 타워(EQ000629 + EQ000630) · GF000320 드론(멀티콥터 EQ000646 + 배터리 EQ000647 · 헬리콥터 EQ000645 갈래) | +| 참고(둘 아님) | 1 | GF000145 4륜구동 1톤 덤프트럭 — **한 대**가 EQ000655(가격)과 EQ000069(계수 · 연료)를 같이 읽음 | +| ㉢ 로직 길에 남은 기초 | **0** | 로직 1,520 = 변환 1,520 = 저장 1,520 → 수식 문서 없는 기초 없음. 남은 「로직 길」 = 기계 식 고름이 **옛 로직 JSON 입력 고르기**를 읽음(`M02_Machine_Hourly._family/pick/combo` · `M01_MasterData_Machine.register` 가 로직 JSON 의 기계 목록을 고침) | +| 기계 목록 두 벌 | — | 로직 입력 고르기 vs 수식 문서 선택 목록: [실측] 선택 변수 2,751 개 비교 **다름 0**(지금은 같음). **M01 [새 기계] 저장이 로직 JSON 목록만 고치고 문서는 안 고침**(문서 쪽 코드 없음 · grep) → 앞으로 어긋남 위험 | + +- 조합 줄 묶음 제목 = 이미 「굴착기+부착용 집게 0.2㎥」 · 「굴착기(무한궤도) 0.7㎥ + 대형브레이커 0.7㎥」 꼴 → 나눈 줄 둘이 **같은 제목 아래** 들어가면 「그룹 제목 유지」 와 맞음. +- 반대로 한 묶음 제목 아래 기계 줄이 이미 여럿인 문서 = **3 장**(GC000091 · GC000092 · GC000100 의 「소모자재(크롤러드릴) · 소모자재(대형브레이커)」 묶음 = 재료 줄 성격). 기계 줄을 가진 문서 501 장 · 기계 줄 1,060 개 중 묶음 이름을 단 줄 1,035 개(거의 한 묶음 = 한 기계). +- 한 EQ 줄이 둘을 품은 기계(줄 나눔 대상 아님 · 원문 표가 한 덩이): EQ000631 「소형굴삭기+부착용집개」(산림 2-2-3) · EQ000183 ~ 186 「트럭 트랙터 및 평판트레일러」. + +**추천(H)**: ㉠ 75 줄(67 장)이 본체 · ㉡ 5 줄은 한 줄 단가 식 안에서 기계 손료를 합하는 식이라 **별도 판단**(작업량 · 시간 단위가 기계 줄 시간당이 아님). + +--- + +## I. 나눴을 때 금액 + +### I1. 조합 식 줄 구성(사실 · `수식문서/수식_건설품셈_08장_건설기계.json`) + +| 줄 | GC000270(굴착기 + 집게) | GC000271(굴착기 + 대형브레이커) | +| --- | --- | --- | +| 주연료 | `P_기계주연료`(**굴착기 값** · `EQ:{S_기계}`) × 경유 단가 — 부착 기계 연료 없음 | 같음 | +| 조종원 | `Q_기계조종원`(굴착기) × 시간환산 × 운전사 노임 — 부착 기계 조종원 없음 | 같음 | +| 잡재료비 | **재료비 × `r_조합잡재료` ÷ 100**(CC000074 「불도저 및 굴착기 잡재료 비율」 적용 = **16 %**) · 굴착기 자신의 잡재료율(21 · 22 %)은 안 씀 | 같음 | +| 기계손료 | 굴착기 `(상각 + 정비) × (1 + 가산 ÷ 100) + 관리` 계수 · 보정작업 가산 적용 | 같음 | +| 부착 손료 | `집게손료` = `버림(P_집게 × 1000 × (상각 + 정비 + 관리 계수) ÷ 1e7, 0)` — **보정 가산 안 걸림** · 별도 줄 | `브레이커손료` · 같은 꼴 | +| 끝수 | 줄 버림 0.1 · 비목 버림 0(`끝수` 문서 칸) | 같음 | + +- 부착 기계(집게 3 · 브레이커 6)의 EQ 값에는 **주연료 · 인력 · 잡품 · 작업량이 없음**(값 칸 확인) — 8-4 운전경비표에도 7206 · 0230 줄 없음 · 8-3 손료표에만 있음. + +### I2. 품셈 원문(8 장) + +`resources/knowledge/original/원가계산/건설공사_표준품셈/본문/01_공통부문/제08장_건설기계/` + +- `8-04_운전경비_산정.md:378` [70]기타기계 주⑤ — 「불도저 및 굴착기에 리퍼, 브레이커, 부착용집게를 조합하여 사용할 때는 **불도저 및 굴착기의 잡재료 비율을 16%로 계상하고, 리퍼, 브레이커, 부착용 집게의 손료 및 치즐 소모율을 추가**하는 것이다.」 → 부착 기계는 **손료만 더하고** 연료 · 조종원은 굴착기 것 한 벌, 잡재료 율은 **16 %로 바뀜**. +- `8-02-13_대형브레이커.md` 1 · 주③ — 「조합기계 대형브레이커+굴착기 0.6~0.8㎥」 · 「작업보조로서 보통인부 1인을 **별도** 계상」 → 작업능력 표는 **조합 한 덩이**의 시간당 작업량(굴착기 작업량과 별개 표). +- `8-04_운전경비_산정.md:375-376` 주②③ — 잡재료 = 「주연료비의 비율」 · 삽날 · 타이어 소모율은 잡재료에 포함. + +### I3. 실제 셈 — 216 짝 전수(굴착기 × 부착 × 보정작업 3 갈래 · 지역 전국평균) + +`tmp/brain_889/_목록_조합_분할_대조.tsv` · 스크립트 `_split_calc2.py`. 「단독 식」 = 그 굴착기가 목록에 든 첫 식(전부 GC000267) · 「부착 손료만」 = 3 계수 합 공식과 **GC000273**(손료계수 한 칸 · 기존 식)을 둘 다 셈. + +| 비교 | 조합 식 | 건수 | 결과 | +| --- | --- | --- | --- | +| 단독 식 + 부착 손료(덮음 없음) | GC000270 | 54(6 × 3 × 3) | 노 · 경 같음 · **재료비 다름 54/54**(차 461 ~ 2,160 원/시간) | +| 〃 | GC000271 | 162(9 × 6 × 3) | 재료비 다름 162/162(차 296 ~ 3,634 원/시간) | +| 부착 손료 3 계수 합 vs `손료계수` 한 칸 | 두 식 | 216 | **같음 216/216** → 기존 **GC000273 이 「부착 기계 손료만 식」 으로 그대로 쓸 수 있음**(9 개 부착 기계 모두 GC000273 목록에 듦 · 경비 값 일치) | +| 굴착기 줄에 **잡품 율 16 %** 덮음(`기계덮음 {기계: {잡품: [{줄: 주연료, 율: 16}]}}`) + 부착 손료 | 두 식 | 216 | **노 · 재 · 경 모두 같음 216/216** | + +- 차이의 정체 = 하나: **잡재료 율**(굴착기 단독 21 · 22 % ↔ 조합 16 %) × 주연료비. 연료 · 조종원 · 가산 · 손료 끝수는 같음(손료 둘은 각각 정수로 버림되어 합이 안 흔들림). +- 예: GC000270 · 0201-0060 + 7206-0070 · 보정 없음 → 조합 110,075 · 단독 + 손료 111,205(차 +1,130 = 재료비 22 % vs 16 %) · 덮음 16 % 후 110,075. + +### I4. 문서 단위 — 호출 문서 67 장을 실제로 갈라 셈 + +`tmp/brain_889/_목록_조합_분할_문서대조.tsv` · `_split_docs.py`(메모리 안 · 파일 안 고침). 갈래 방식 = 「조합 식에서 부착 몫만 뺀 굴착기 식(잡재료율 조합 16 % 그대로) + 부착 줄은 GC000273」 로 줄 둘 · 기본 옵션 기준. + +| 결과 | 문서 수 | 까닭 | +| --- | --- | --- | +| 노 · 재 · 경 모두 같음 | **59** | — | +| 경비 −1 원 | 2(GC000339 · GF000289) | 줄이 둘이 되어 줄 끝수(0.1 버림)가 한 번 더 걸림 — **끝수** | +| 재료비 −23 ~ −52 원 | 6(GC000087 · 090 · 091 · 092 · 098 · 100) | 식 줄 `C_브레이커 = P_굴착기무한궤 × …` 이 조합 식의 **값 전체(굴착기 + 브레이커 손료)** 를 밑으로 「소모재료(치즐)」 를 셈 → 굴착기 줄만 남으면 밑이 줄어듦. 나눈 뒤 이 식은 두 줄 값의 합을 읽도록 고쳐야 함 | + +- [짐작] 위 6 장은 조합 값을 **「조합 한 덩이 = 굴착기 + 브레이커」** 로 다시 쓰는 식 · 분할 때 같이 고칠 자리(원문 주⑤ 「치즐 소모율을 추가」 의 밑). 못 한 것: 옵션 조합 표본(기본 옵션만 대조 — 문서 옵션이 수천 갈래). + +### I5. 나눈 두 줄이 같은 「시간당 작업량」 을 쓰게 하려면 + +- 지금 엔진 [사실]: 조합 줄의 작업 기계 = **부착 기계**(입력에 `기계` 외 부착 입력이 있으면 `tool[-1]` — `scripts/master_doc_work.py:322-332`) → 시간당 덮음은 부착 기계 열쇠로만 효력. +- [실측] GC001070(궤광철거 · 조합 줄) 시간당 덮음: 굴착기 열쇠 → 효과 없음(금액 그대로 14,975,941) · 부착 열쇠 → **「시간당 작업량 식 없는 기계」 로 줄 멈춤**(계 「—」). `_work_probe.py`. +- 나누면: 굴착기 줄 = 굴착기 작업량 식(GC001147 · 시간당 ㎥/hr · 기계 값 `작업량`)로 시간당 전환 **가능**. 부착 줄 = 작업량이 없음(EQ 에 칸 없음) → 일당 수량(`Q_표 × 8 ÷ Q_시공`)에 남아 **굴착기 줄과 어긋남**. +- 필요한 것: ① 부착 줄 수량 = 굴착기 줄 수량(같은 식 글 복제로는 안 됨 — 작업량 자리 찾기(`sites`)가 줄 글 안의 `8 ÷` 꼴을 봄 · 변수 하나로 감싸면 못 찾음 · `scripts/master_doc_work.py:130-148, 179-188`) → **「부착 줄이 같은 묶음의 굴착기 줄을 따름」 규칙을 엔진에 추가**(파이썬 `master_doc_work.py` + TS `cu/common_util_formula_doc_work.ts` 짝 · 거울 시험 `test_846_1_machine_work.py`). ② 덮음 열쇠(847-1)가 부착 줄 열쇠를 굴착기 줄로 읽도록. +- 조합 작업량 표 [사실]: 조합 줄 수량의 `Q_굴착기부착용^표` 는 소요량표(예 GC001070 = QC001973)의 **「굴착기+부착용집게(0.2㎥)」 조합 칸 값**(일당 시간). 나눈 뒤에도 일당 방식은 그 표 값을 그대로 두 줄이 공유해야 금액이 같음(위 I4 가 이 가정으로 셈). + +### I6. 불러오기 규칙과의 맞음 + +- [사실] 불러오기는 이미 **조합 = 조각마다 줄**: `M02_Machine_Find.parts` 가 「+」 · 괄호 속 다른 기종을 갈라 부분마다 찾고 · `M02_San_MyMachine` 이 「첫 조각 = 첫 손료 + 연료 · 조종원 / 다음 조각 = 그 차례 손료만」 으로 내 기계를 만들며 · `M02_San_Emit.part_line` 이 다음 줄을 만듦(`M02_San_Emit.py:199-215`). +- [사실] 다만 두 기계가 우리 조합 식(GC000270 · 271) 목록에 있으면 `M02_San_Link.combo_link`(`:143-150`) → `M02_Machine_Hourly.combo`(`:275-293`)가 **첫 조각에 조합 식을 부르고 다음 조각은 값 0**(`M02_Doc_Import.py:246-247` 「우리 조합 식 … 에 듦(첫 줄) — 이 줄 값 0」). **이 분기가 조합을 한 줄로 합침**. +- 따라서 줄 나눔 = 이 분기 제거 → 둘째 조각이 `hourly_text(part["키"])`(그 기계 자체 시간당 · 집게 · 브레이커는 `pick` 이 GC000273 계열을 고름) 경로를 타 **불러오기 규칙과 이미 맞음**. 단 첫 조각이 굴착기 단독 식(잡재료 22 %)이 되므로 **16 % 덮음(또는 조합용 굴착기 식)** 을 불러오기도 얹어야 원문 주⑤ 와 맞음. + +**추천(I)**: 「굴착기(잡품 16 %) 줄 + GC000273 부착 손료 줄」 구조 · 새 식 문서가 필요하면 GC000270/271 에서 부착 몫만 뺀 「굴착기(조합용) 식」 하나(덮음 없이 16 % 내장)가 덮음 열쇠 문제(D4 기계 열쇠 공유)를 피함 · 엔진은 「부착 줄이 굴착기 줄을 따름」 규칙만 추가. + +--- + +## J. 걸림 · 위험 + +### J1. 깨질 수 있는 곳 + +| 번호 | 곳 | 위험 | 근거 | +| --- | --- | --- | --- | +| 1 | 자동 따라옴 `M02_Sk_AutoRenew` | 기계 줄 **통째 지문** → 비고 · 출처 변경만으로 덮음 삭제 · 문서 지문에 `기계덮음` 포함 → 기초 덮음 고침이 따로 문서를 지울 길 | D3 | +| 2 | `renew.carry` | 기초 덮음 · 내 덮음 통째 갈음(합침 없음) | `M02_Sk_AutoRenew.py:245-247` | +| 3 | `prune_doc` | 안 부르는 기계 덮음 삭제 → 옵션 바꾸고 저장하면 사라짐 | `scripts/master_doc_cover.py:446-447` · `test_836_1…:318-324` | +| 4 | 사본 줄이기 `M02_Copy_Slim` · 빈틈 `M02_Doc_Gap` | 고른 기계 줄만 남김 → 바탕 없음(고르지 않은 기계) · 저장마다 바탕이 지금 값으로 덮임 | `M02/M02_Copy_Slim.py:1-12` | +| 5 | 굳히기 `Item_Sangeun.freeze` · `Doc_B09` | `수식` 칸 통째 복사 → 새 칸(`기초덮음`)은 자동 동행 · **셈 호출부(C2 의 5 곳)가 합친 cover 를 넘겨야** B09 `sk_money` 가 같은 값 | `M02/M02_Item_Sangeun.py:88-89` · `M02/M02_Doc_Copy.py:142-147`(`dc.run` 한 곳) | +| 6 | 옛 로직 사본 길 `doc_of` | SK 사본 줄이 지금 M01 줄과 다르면 문서를 **옛 줄에서 변환**(덮음 없는 문서) → 기초 덮음이 안 실림 | `M02/M02_Doc_Copy.py:77-91` | +| 7 | 불러오기 가져온 식 | 단가기준 「엑셀」 = 엑셀 값 그대로 · 덮음 무시 가능 · 조합식 분기(I6) · 지금 `_covers` 는 가져온 식에도 돎 | `M02/M02_Doc_Import.py` · `M02_Sk_AutoRenew.py:139-144` | +| 8 | 내 기계 | 덮음 열쇠 = `개인 EQP…` 글 · 내 기계도 같은 층 모델 필요(위 층 = 본뜬 M01 기계) · 지움 시 알림 `쓰는곳` | `M02/M02_MyMachine.py:181-185, 464-472` | +| 9 | 기계 보기(840-2) | `cu/common_util_machine_sheet` 가 덮음 ↔ 기계 줄 변환 · 「처음 줄」 기준 · `is-changed` 훅 있으나 스타일 없음 | `A00/line_stack_machine_sheet.ts:82, 308-406` | +| 10 | 기계 목록 두 벌 | M01 [새 기계] 가 로직 JSON 목록만 고침(문서 쪽 안 고침) → 선택 목록 어긋남 | `M01_MasterData_Machine.py:134-182` | +| 11 | 시험 | 파이썬 ↔ TS 거울 시험 · 빌더 `--check`(`test_802_2_convert.py` = 싱크 핵심 시험) · 842-3 조종원(싱크 핵심) | `tools/sync_core_tests.txt` | +| 12 | 빌더 | 사람 편집 이어받기 없음(B3) · 기계 목록 어긋남(10) | B | + +- [실측] 관련 시험 4 파일(`test_836_2_sk_auto_renew` · `test_836_1_machine_cover` · `test_846_1_machine_work` · `test_802_4a_m02_doc`) **58 건 통과**(`--basetemp tmp/brain_889/pt`) — 시작 상태 기준선. +- 시험이 언급하는 파일(고칠 때 같이 돌릴 대상): `M02_Sk_AutoRenew` → 795_1 · 796_2b · 802_4a · 821_1 · 822_1 · 823_1 · 826_3 · 827_1 · 836_2 · `master_doc_cover` → 836_1 · 840_2 · 842_3 · 846_1 · 847_1 · `M02_Doc_Sk_Path` → 17 파일(836_1 · 836_2 · 836_5 · 841_1 …) · `M01_MasterData_Doc` → 802_3 · 804_2 · 804_7 · 813_2 · 840_2 · 842_3 · 빌더 → 802_2. + +### J2. 옛 저장본 + +- [실측] storage 의 SK = **5 건**(회사 1 개인 3: 4 건 가져온 식 · 회사 3 개인 15: 1 건 바탕 GC001142) · 전부 `기계덮음` 0 · `따로` 0 · 부름 0 · 프로젝트 B09 `수식.json` 0 · `기계덮음` 글자를 가진 파일 0(storage 템플릿 · B09 폴더 검색). 시스템 층 `resources/master_template/sangeun/` 없음. `tmp/backup_m02_reset_1114` = 11-14 M02 비움 흔적. +- → 새 칸 도입 · 판정 규칙 교체 때 **옮기기 도구 불필요**(새 칸은 없으면 빈 것으로 읽으면 됨). + +### J3. 걸음을 파일이 안 겹치게 나누는 제안(짐작) + +| 걸음 | 대표 파일 | 선행 | 겹침 | +| --- | --- | --- | --- | +| ① 자료 · 셈 · 빌더 · M01 저장 | `scripts/master_doc_cover.py` ↔ `cu/common_util_formula_doc_cover.ts`(층 합침 · `base` 인자) · `M02/M02_Doc_Copy.py`(`run` 에 cover 합침) · `build_수식문서_802_2.py` · `M01_MasterData_Doc.py`(`prune_doc` 호출 · 덮음 유지) · 시험 836_1 · 842_3 · 846_1 · 802_2 | 없음(계약 먼저 = 안 C① 칸 이름) | — | +| ② 갱신 | `M02/M02_Sk_AutoRenew.py` · `M02/M02_Doc_Copy.py`(`state` · `fp` 제외 칸) · `M02/M02_Sangeun_Copy.py`(`_formula_job` · 바탕 보관) · 시험 836_2 | ① 칸 이름 | `M02_Doc_Copy.py` 가 ①과 겹침 → ①이 `run` 만 · ②가 `state` 만으로 가르거나 순차 | +| ③ 화면 | `A00/line_stack_machine_ctl.ts` · `line_stack_edit.ts` · `line_stack_screen.ts`(`calcSub` · readOnly) · `formula_doc_copy.ts` · `formula_doc_renew.ts` · `ui_template/ui_template_input.{ts,css}` 등 부품 · `line_stack_machine_sheet.ts` · M01 LogicLab 잠금 | ① 칸 이름 · 서버가 실을 「바탕 지도」 | 위 두 걸음과 파일 안 겹침 | +| ④ 기계 줄 나눔 | 문서 자료(`로직_*.json` → 빌더 → 수식문서 · 75 줄 · 67 장) · 엔진 「부착 줄이 굴착기 줄을 따름」(`scripts/master_doc_work.py` ↔ `cu/common_util_formula_doc_work.ts`) · 불러오기 분기 제거(`M02_San_Link.py` · `M02_San_Emit.py` · `M02_Doc_Import.py` · `M02_Machine_Hourly.combo`) · 시험 846_1 · 814_1 | ① 이후(같은 cover 계약 · 빌더) | 엔진 짝이 ①(cover)과 같은 쌍 계열 → **① 뒤** 또는 같은 창 | +| ⑤ 영향 목록 · 쓰는 곳 | `M01_MasterData_Machine.py` · `M02_MyMachine.py` · 새 색인 | 독립 | 독립 | + +- 병행 가능: ②와 ③(파일 안 겹침) · ⑤. ①→④ 는 순차. + +### J4. 추천(J) + +①을 먼저 단독으로 계약(칸 이름 · 합침 규칙 · 판정 지문 제외 칸)까지 굳히고, ② ③ ⑤ 병행 · ④ 는 ① 뒤. 계약 전에는 화면 · 갱신이 만들 칸 이름이 갈림. + +--- + +## 못 함 · 한계 + +| 항목 | 까닭 | +| --- | --- | +| 브라우저 화면 실제 캐시 · 테두리 렌더 확인 | 화면 조작 금지 범위 | +| 따로 SK 에서 [M01 값으로] 가 실제로 409 인지 | 코드 읽기만(임시 storage fixture 필요) · 시험 `world` 사용은 쓰기 동반 | +| 옵션 조합 표본의 조합 · 분할 금액 대조 | 기본 옵션 + 보정작업 3 갈래만(문서 옵션이 수천 갈래) · 지역 전국평균 하나 | +| M01 기계 상세 · 내 기계의 [되돌림] 단추 유무 | `MachineDetail.ts` 에서 [목록으로] · [삭제] 만 확인 | +| SK 수백 건 규모의 열기 · 영향 비용 | 실 SK 5 건 · warm 0.1 ~ 0.2 초 곱셈 추정만 | +| 일반 수식 문서(덮음 아닌 칸) 편집 이어받기 | 범위 밖이나 B5 안 α 의 한계로 기록 | + +--- + +## 부록 — 파일 + +| 파일 | 내용 | +| --- | --- | +| `tmp/brain_889/_목록_기계둘_줄.tsv` | H 전수(81 행) | +| `tmp/brain_889/_목록_조합_분할_대조.tsv` | I3 216 짝 | +| `tmp/brain_889/_목록_조합_분할_문서대조.tsv` | I4 문서 67 장 | +| `tmp/brain_889/_목록_기계_쓰임_수.tsv` | G2 기계 655 대 쓰임 수 | +| `tmp/brain_889/_목록_갱신_판정.tsv` | D 지문 · 지움 전수 | +| `tmp/brain_889/_목록_초기화_단추.tsv` | E 단추 전수 | +| `tmp/brain_889/_목록_제어자리_테두리.tsv` | F 자리 전수 | +| `tmp/brain_889/_build_check.txt` | 빌더 `--check` 결과 | +| `tmp/brain_889/_*.py` | 측정 스크립트(읽기 전용) |