knowledge(품셈md): 품셈 md 작성 규칙 추가 — 절 하나 파일 하나 · PDF 만 기준 · 검증 셋

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QqkvdyxUtANWroVKpQUyxE
2026-09-19 01:10:17 +09:00
parent 9629430aff
commit c7ee558924
1 changed files with 84 additions and 0 deletions
@@ -0,0 +1,84 @@
+# 품셈 md 작성 규칙 (산림·건설 공통 · 2026-09-19)
+
+품셈 PDF 를 **절 하나 = md 파일 하나**로 옮길 때 지킬 것. 목표는 「PDF 와 md 가 완벽히 같음」.
+이 단계의 **판정 기준은 PDF 뿐임.** 원가계산(B09) · 공종 마스터 · 원천 벌 · 금액 시험은 참고도 하지 않음.
+
+## 1. 자리와 이름
+
+```
+산림_표준품셈/본문/제NN장_<장이름>/<절번호>_<절이름>.md        예) 제09장_토공/9-05_발파암.md
+건설공사_표준품셈/본문/<부문폴더>/제NN장_<장이름>/<절번호>_<절이름>.md
+```
+
+- 파일 단위는 **절(N-N)**. 절 앞에 오는 장 머리글은 `0-00_장머리.md`.
+- 한 절이 40쪽을 넘으면 항(N-N-N) 단위로 더 쪼갬 — `8-03-01_…md`.
+- 이름의 빈칸은 `_`, 파일 이름에 못 쓰는 글자(`/ : * ? " < > |`)는 뺌. 절 번호는 두 자리로 맞춤(`9-05`).
+- 옛 md(산림 단일 파일 · 건설 장별 45 · 합본)는 **고치지 않음.** 새 md 는 `본문/` 아래에만 씀.
+
+## 2. 파일 머리
+
+```
+---
+문서: 산림사업 표준품셈(산림청고시 제2025-82호)
+절: 9-5 발파암
+PDF쪽: 135~136
+인쇄쪽: 123~124
+시작표지: 9-5 발파암
+끝표지: 9-6 발파암 소할
+상태: 작성중
+작성:
+검증:
+원천: 글자층
+기계검사:
+확정지문:
+---
+```
+
+- `상태` 는 `대기 → 작성중 → 검증대기 → 확정`. 작성한 창은 자기 파일을 `확정` 으로 못 올림.
+- `원천` 은 `글자층`(PDF 에 글자가 있음) 또는 `그림`(글자층이 없어 그림을 보고 받아씀).
+- `기계검사`·`확정지문` 은 도구가 적음. 손으로 적지 않음.
+
+## 3. 받아쓰기
+
+1. **첫 줄부터 PDF 쪽 그림과 맞대어 씀.** 옛 md · HWPX 에서 뽑은 글은 초안으로 가져와도 되나, 그대로 믿지 않음.
+2. **숫자·단위·기호는 한 글자도 안 바꿈.** `1,000`↔`1000` · `㎥`↔`m3` · `∼`↔`~` · `×`↔`x` 로 바꾸지 않음. 소수 자릿수도 그대로(`0.50` 을 `0.5` 로 줄이지 않음).
+3. 자간을 벌려 찍은 글자(「특 별 인 부」 · 「구 분」)는 붙여 씀(「특별인부」 · 「구분」). 낱말 사이 띄어쓰기는 PDF 대로.
+4. 쪽 머리·꼬리(쪽 번호 · 되풀이되는 장 이름)는 뺌. 절 제목 옆 개정 표지(`('08, '20, 25년 보완)`)는 본문이므로 남김.
+5. 제목 단계 — `#` 장 · `##` 절 · `###` 항 · `####` 목. 번호와 이름은 PDF 글자 그대로.
+6. 표 위의 밑수 줄(`(단위: 10㎡당)` · `(㎥당)`)은 **표 바로 위 한 줄로** 반드시 적음.
+7. 표 아래 `[주]` · `비고` · `※` 는 빠짐없이, 번호(①②③ · 가나다)도 그대로. 표 안 마지막 줄에 든 비고는 표 안에 둠.
+8. 식은 글자로 옮김(`Q = 3,600 × q × f × E / Cm`). 위·아래 첨자는 `^` `_` 로(`10^-7`).
+9. 원문이 틀려 보여도 **고치지 않음.** 그대로 적고 그 줄 아래 `<!-- 원문 그대로: … -->` 로 남김.
+
+## 4. 표
+
+1. PDF 의 한 줄 = md 의 한 줄. 한 칸 안에 줄바꿈이 있으면 `<br>` 로 이음. **여러 줄을 한 칸에 뭉치지 않음.**
+2. 병합 칸은 **걸친 칸마다 같은 값을 되풀이해 적고**, 표 바로 아래 주석으로 남김.
+   `<!-- 병합: 1열 2~4행 「인력시공」 -->`
+3. 머리가 두 단이면 `윗머리 › 아랫머리` 로 한 줄에 펼침. 윗머리에 든 단위·밑수(`시간당(10^-7)`)를 잃지 않음.
+4. 빈 칸은 빈 칸. `〃` · `-` · `·` 는 그대로 적음(위 값으로 채우지 않음).
+5. 한 표가 쪽을 넘어가면 **한 표로 이음.** 넘어간 쪽에서 되풀이된 머리 줄은 뺌.
+6. 표가 너무 넓어 PDF 가 두 표로 나눠 찍었으면 PDF 대로 두 표.
+
+## 5. 그림
+
+- 도해·그래프는 잘라 같은 장 폴더의 `pic/<절번호>_<차례>.png` 에 넣고 `![그림 설명](pic/…png)` 로 검.
+- 그림 안의 수치·글자는 그림 아래에 글로 옮김.
+- 글자층이 없는 그림형 표는 그림을 보고 받아쓰고, 머리 `원천` 을 `그림` 으로 적음. 이 파일은 기계검사 ①② 대신 **검증 창 둘**이 따로 받아써 맞댐.
+
+## 6. 검증
+
+| 검사 | 누가 | 통과 기준 |
+|---|---|---|
+| ① 수 대조 | 도구 `pum_md_tool.py check` | 그 절 PDF 글자층의 모든 수 = md 의 수(갯수까지). 결손 0 · 허구 0 |
+| ② 글자 대조 | 도구 | PDF 글자(공백 뗌)가 md 에 빠짐없이 있고 md 에 없는 글자가 더해지지 않음 |
+| ③ 자리 대조 | **작성하지 않은 다른 창** | 쪽 그림을 보며 표마다 수가 제 줄·제 칸에 있는지 · 병합 · 머리 · 밑수 · [주] |
+
+- ①②가 0 이어도 칸이 뒤바뀐 것은 못 잡음 → ③ 없이는 `확정` 아님.
+- ③에서 고칠 곳이 나오면 검증 창이 고치지 않고 **작성 창에 돌려보냄**(줄 번호 + PDF 쪽 + 무엇이 다른지).
+- `확정` 뒤 파일이 바뀌면 시험이 빨강. 고치려면 상태를 `작성중` 으로 되돌리고 ①②③ 다시.
+
+## 7. 커밋
+
+- 파일 하나 끝낼 때마다 커밋·push. 메시지 `knowledge(품셈md): 산림 9-5 발파암 작성` / `… 검증 확정`.
+- 남이 집은 파일(머리 `작성` 칸에 다른 창 이름)은 건드리지 않음.