knowledge(원가·STC): 검증 지적 4건 반영 — XOR 프로브 스크립트·표현 완화·상태 각주

- _scripts/xor_probe.py 신설: 키스트림 후보 유도 가정·계산 범위·한계 명시,
  파일 간 일치율·공백 복원 데모 출력. STC_난독화_상태 §2에 실행 명령·출력 기록
  (SYSINFO 7파일 100%·BDQTY 83~100%·공백 복원 82~91% — 재현 가능해짐)
- 단수처리_규칙: "설계연도 무관 규칙" → "2024~25 STmate 산출물 5건 관측 구현
  후보 규칙"으로 완화, 일반화 전 미확정 5요소(타 버전·발주기관·법령 의무·
  CUTNM·예외값) 명시, "5건 전부 일치" → "항목 존재 파일 전부 동일"
- 입출력변수사전(verified): 조달수수료·D9-1·D10 신규 행에 검증 범위 밖
  ⚠ 각주 (evidence=observed, 미결 No.20 연동) — 문서 상태는 유지
- 표현 완화 2곳: "포맷 고유 특성 확정" → "강한 증거 (알고리즘 미확정)"
  (교차비교·_STC포맷분석), extract_rounding.py 주석 6개→5개 정정

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-15 19:46:57 +09:00
co-authored by Claude Fable 5
parent 89e3b034e9
commit 67d04ed8fa
9 changed files with 136 additions and 16 deletions
@@ -14,8 +14,8 @@ last_updated: 2026-08-15
관련 문서: [원가계산_체계](원가계산_체계.md) · [제비율](제비율.md) · [원가_출력변수_사전 §F](원가_출력변수_사전.md) · [자재단가_적용](자재단가_적용.md)
> **★ 이 문서의 성격**: 실무 내역서(과거 데이터)에서 추출한 것은 **당시 금액·요율이 아니라 단수처리 로직**(어느 단계에서 어느 함수로, 어느 자릿수까지 처리하는가)이다. 로직은 설계연도와 무관하게 재사용 가능한 계산 규칙이므로 기술DB화 대상. **값(0.54 %·14.5 % 등)은 특정 공사지 관측**일 뿐 확정 기본값이 아니다([00_운영지침 ★근본원칙](../../../00_운영지침.md)).
> 관측 소스: 실무 xlsx는 STmate가 생성한 것으로 계산식이 셀 수식에 그대로 노출됨. **5개 공사지(기번3·봉화·영월 임도 + 계류보전 사방 + 소광) 교차** — 아래 규칙은 5건 전부 일치분만 규칙화, 단발 관측은 ⚠.
> **★ 이 문서의 성격**: 실무 내역서(과거 데이터)에서 추출한 것은 **당시 금액·요율이 아니라 단수처리 로직**(어느 단계에서 어느 함수로, 어느 자릿수까지 처리하는가)이다. 단, 이 로직은 **조사한 2024~2025년 STmate 생성 XLSX 5건에서 반복 관측된 구현 후보 규칙**이지 법정·범용 규칙이 아니다 — 현행 규정 원문(§5)·프로그램 설정(Start8x.Ini `CUTNM` 관계 미확정)·타 STmate 버전·타 발주기관 대조 전까지 확정하지 않는다. **값(0.54 %·14.5 % 등)은 특정 공사지 관측**일 뿐 확정 기본값이 아니다([00_운영지침 ★근본원칙](../../../00_운영지침.md)).
> 관측 소스: 실무 xlsx는 STmate가 생성한 것으로 계산식이 셀 수식에 그대로 노출됨. **5개 공사지(기번3·봉화·영월 임도 + 계류보전 사방 + 소광) 교차** — 아래 규칙은 **해당 항목·수식이 존재하는 조사 파일 전부에서 동일**한 것만 규칙화(예: 조달수수료는 관급 있는 파일에서만 관측 가능), 단발 관측은 ⚠.
## 1. 단수처리 함수 — 위치별 3종 (★핵심)
@@ -69,7 +69,15 @@ STmate 내역서는 **계산 위치마다 다른 단수 함수**를 쓴다. 이
| 집계표 반올림 | ROUND | 검산·표시용 추정 — 근거 불요 가능 |
| 보험료 끝수 | — | 국고금관리법 §47(끝수 계산 안 함) = 건보법 §107 경유. 원가계산 절사와 별개 체계 |
> [구현] 단수 함수·자릿수·시점은 5공사지 실무 일관 관측이나 **현행 법령·기준 원문 대조는 미완**. 프로그램 기본값 확정 전 조달청 예정가격 작성기준 등 원문 확인(사용자 협의). 실무 일관성은 강한 실증이나 §00_운영지침상 현행 근거 우선.
**일반화 전 미확정 요소 (전부 ⚠)**:
1. 타 STmate 버전에서도 동일한가 (조사분 = w24.04 계열 2024~2025 산출물)
2. 타 발주기관·설계사무소에서도 동일한가 (조사분 = 남부청 계열 5건)
3. 법령상 의무적인 단수처리인가, 프로그램 관행인가
4. 사용자 설정값으로 바뀌는가 — Start8x.Ini `CUTNM=0` 관계 미확정 ([STC_컨테이너_구조 §5](../../../original/원가계산/STmate/STC_컨테이너_구조.md))
5. 예외값(음수·0원 행·면세 공제) 처리 규칙
> [구현] 단수 함수·자릿수·시점은 조사 파일 전부 일관 관측이나 **현행 법령·기준 원문 대조는 미완**. 프로그램 기본값 확정 전 조달청 예정가격 작성기준 등 원문 확인(사용자 협의). 실무 일관성은 강한 실증이나 §00_운영지침상 현행 근거 우선.
## 근거
@@ -148,6 +148,8 @@ last_updated: 2026-08-15
| rate_vat | 부가가치세율 | 총원가 | 10 % | D9 |
| rate_procurement_fee `[표]` (구매방식·금액별 추정) | 조달수수료율 | 관급 순자재대(government_material_base) | 실무 관측 0.54 % (과거) / **현행 원문 미확보 ⚠** | D9-1 |
> ⚠ **rate_procurement_fee 행은 문서 status(verified) 검증 범위 밖** — 2026-08-15 추가분, evidence = 실무 관측(observed)뿐이고 현행 원문 검증 전([미결 No.20](../../../03_미결_및_확인사항.md)). 원문 확보·검증 후 본 검증 범위 편입.
## G8. 할증·보정 계수 — 품셈 개정 연동 (준정적)
| 변수코드 | 한글명 | 값 구조 | 총람 연결 |
@@ -233,8 +233,10 @@ last_updated: 2026-08-15
| D7 | 일반관리비 | (재+노+경) × 율 | 필수 | |
| D8 | 이윤 | (노무비+경비+일반관리비) × 율 | 필수 | |
| D9 | 부가가치세 | 총원가 × 10% | 필수 | |
| D9-1 | 조달수수료 (procurement_fee) | 관급 순자재대(government_material_base) × 조달수수료율, **원단위 절사** | 높음 (관급 있을 때) | |
| D10 | 관급자재대 (government_material_total) | = ROUNDUP(순자재대 + 조달수수료, **천원**) 별도 표기 (총원가 밖) | 필수 | |
| D9-1 | 조달수수료 (procurement_fee) ⚠ | 관급 순자재대(government_material_base) × 조달수수료율, **원단위 절사** | 높음 (관급 있을 때) | |
| D10 | 관급자재대 (government_material_total) | = ROUNDUP(순자재대 + 조달수수료, **천원**) 별도 표기 (총원가 밖) ⚠ 단수·산식은 실무 관측 | 필수 | |
> ⚠ **D9-1·D10 산식 갱신분(2026-08-15)은 문서 status(verified) 검증 범위 밖** — evidence = 실무 xlsx 관측(observed, [단수처리_규칙](단수처리_규칙.md))이며 현행 원문 검증 전(조달수수료율 = [미결 No.20](../../../03_미결_및_확인사항.md)). F3-2 갱신분 동일.
| D11 | 품 할증 (작업시기·경사·이동거리·집단화 등 26계열) | 품 × 계수 | 조건부 — 실무 미적용 관측, [품셈_적용기준 §2](../04_수량분석정보/품셈_적용기준.md) | |
| D12 | 자재 할증 — **모래는 용도별** (품셈 1-3-1): 콘크리트·포장용 잔골재 10/12 % · **노상·노반재료 6 %** · **관류·구조물기초 부설 4 %** (임도 주용도 = 후 2자). 그 밖 자갈(굵은골재) 3/5 %·노반 부순돌·자갈 4 %·흄관 3 %·떼 10 % 등 → 전표 [수량산출_일반 §3](../04_수량분석정보/수량산출_일반.md) | 수량 × 계수 | 높음 | |
| D13 | 공구손료·잡자재 (주재료비 2~5%) | 비율행 | 높음 | |