docs: STmate 원가 수량 화면 구조 정리

2026-09-13 22:16:59 +09:00
parent 4a4f935c3f
commit 004a1e21ab
1 changed files with 185 additions and 0 deletions
@@ -0,0 +1,185 @@
+# STmate 원가·수량 화면 구조 정리
+
+작성일: 2026-09-13
+
+근거: `30_원자료/ui_form_catalog.txt` · `30_원자료/print_form_map.txt` · `30_원자료/TWM_KANJUB.dfm` · `30_원자료/TPM_KAN_RATE.dfm` · `30_원자료/TWM_KAN_RATE.dfm` · `20_분석/22_UI_폼_분석.md` · `20_분석/19_진행률_장부.md` §3
+
+## 1. 범위와 판정
+
+- 카탈로그의 STmate 고유 폼 150개 가운데 원가·수량 입력, 기초단가, 일위대가·단가산출, 제잡비, 출력에 직접 참여하는 **48개 화면**을 추렸다.
+- `PM_*` 인쇄 폼은 실제 출력 시트와 이어지는 화면만 포함했다. 같은 출력의 세로·가로·수공 변형은 한 행에 묶었다.
+- 계약·실행·기성 화면은 설계 원가 흐름과 맞닿은 것만 `보조`로 표시했다.
+- 조림·방제 등 사업별 설계 화면, 유지보수·다운로드·복구·암호·정보창은 제외했다.
+- 화면 이름과 선택지는 카탈로그 원문을 유지했다. 기능 또는 출력 연결이 원자료에서 확인되지 않은 곳은 `미확인`이다.
+
+## 2. 화면 갈래
+
+### 2.1 내역 입력 — 11개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wBoq` | 공종목록에서 내역서로 항목을 넣는 중심 화면 | `cBox01/02`: `= 이상`~`====== 이상`; `RGrpTo`: `내역서 / 열린 보관함` |
+| `wKongJong` | 공종 목록 조회·선택 | `RdoLevel`: `소계(+=)`~`총대계(+======)`; `RdoIndex`: `코드번호 순 / 명칭 순 / 분류번호 순`; `RdoFilt`: `일위대가/산근전체 / 대공종 해당목록만` |
+| `wMBoq` | 주공종 집계와 계표시 확인 | `CBox01`: `1레벨(소계) 이상`~`6레벨(총대계) 이상` |
+| `wITNum` | 내역서 공종번호 자동입력 | 첫 글자 `공란 / . / ( / - / 추가입력`; 끝 글자 `공란 / . / )`; 번호형식 `가..하… / a..z…`; `Fmt_Typ`: `0 / 00 / 000` |
+| `wBoqRate` | 내역 항목에 할증율 적용 | `Rdo`: `전체(재,노,경 같은 비율) / 비목별(재,노,경 각각)` |
+| `wM_Rate` | 선택 범위의 수량·비목 금액 일괄 보정 | 범위 `내역서 전체 / 선택된 항목만`; 비목별 `절사 / 반올림`; `소수 0위`~`소수 4위값을 적용` |
+| `wExpnd` | 일위대가를 내역 행으로 풀기 | `RGrpToT`: `소계(=) / 계(==) / 합계(===)`; `절삭하여 / 반올림하여`; `소수 4위`~`소수 0위값을 적용` |
+| `wM_Expnd` | 일위대가와 단가산출근거를 내역에 풀어넣기 | 재료·노무·경비·일식 각각 `절사 / 반올림`, `소수 0위`~`소수 4위값을 적용` |
+| `wM_Expnd10` | 일위대가 풀기와 가산 비목 지정 | `입력안함 / 소계(=) / 계(==) / 합계(===)`; 입력 비목 `재료비 / 노무비 / 경비 / 전체`; 결과 비목 `재료비 / 노무비 / 경비 / 해당비목` |
+| `wM_From_XLS` | XLS 자료를 내역으로 불러오기 | 주요 입력 칸·선택지 `미확인` |
+| `wSameCode` | 내역의 동일 코드 처리 | 주요 입력 칸·선택지 `미확인` |
+
+### 2.2 수량 — 2개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wQtyList` | 별도 수량산출서에서 코드별 수량을 조회·연결 | `cBoxCode`: `모든단가 / 노무비 / 재료비 / 경비 / 일위대가 / 중기비 / 단가산출 / 견적단가 / 대가,산근` |
+| `uM_ConQTY` | 수량 자료 변환·연결 | 구체적인 칸과 변환 방향 `미확인` |
+
+### 2.3 일위대가·단가산출 — 7개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wM_Edit_iLWi` | 일위대가표 구성행 수정 | 노임계수 `초기값설정 개별적용 / 기본 / 기타 / 기타-1`~`기타-4 노임산출계수`; 저장비목 `각 해당비목 / 재료비 / 노무비 / 경비` |
+| `wM_Edit_San` | 단가산출근거와 Q식 수정 | 블록 `열블럭 / 행블럭 / 일반`; 함수 `∏ / INT / SIN / COS / TAN / SQRT / √ / ROUND / ROUNDDOWN …`; 연산 `/ / *`; 수량기호 `Q / A / T / N`; 저장비목 4택 |
+| `wM_Edit_EQ` | 표준중기공식 편집 | 삽입 `공식 / 공식+코드` |
+| `wM_Edit_USER` | 사용자 단가산출식 편집 | 주요 입력 칸·선택지 `미확인` |
+| `wM_iLWi_San` | 일위대가·단가산출 자료 조회/연결 | 구체적인 칸과 편집 범위 `미확인` |
+| `wM_Conv_A2W` | 실적단가를 일식단가로 변환등록 | `비목율(단가 => 노,재,경) / 조달청 발표단가 변환적용`; 연결 `공종코드↔분류번호 / 공종코드↔시설코드 / 명칭·규격·단위` |
+| `wM_Boq_ExecX` | 시간·단위당 중기 실행단가 계산·입력 | 절사 단위 `1원 / 10원 / 100원 / 1,000원 / 10,000원 / 100,000원`; 보정 `기본보정 / 노무비 / 재료비 / 경비` |
+
+### 2.4 기준자료(단가·노임·중기) — 10개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wM_JabPum` | 기준 단가 목록 조회·선택 | 코드종류 `모든단가 / 노무비 / 재료비 / 경비 / 일위대가 / 중기비 / 단가산출 / 견적단가 / 대가,산근 / 그림코드`; 검색 `명칭,규격 / 산근내용` |
+| `wM_Edt_Hal` | 기준단가를 비율로 일괄 수정 | `절사 / 반올림`; 화면 안내상 적용단가 0원과 보호표시 항목은 제외 |
+| `wM_Edit_XRate` | 시간당 손료계수 수정 | `계 입력 / 각계수 입력` |
+| `wM_Boxa` | 단가목록 조회·비교 | `변동없음 / 1 단가`~`5 단가 / 최소단가`; 자재·공종 분류 필터 |
+| `wM_Box_H` | 불러간 단가 목록 확인 | `변동없음 / 1 단가`~`5 단가 / 최소단가` |
+| `wM_JDCode` | 공사원가 호환규정코드 검색·입력 | 기준 `명칭 / 명칭·규격 / 분류번호 / 시설코드 / 선택안함`; 검색 `명칭·규격·단위 / 호환규정코드 / 군급목록번호 / 중기품셈코드 / 시설코드번호`; 종류 `기본 / 자재 / 경비 / 중기 / 실적·기타` |
+| `wM_Mrg_BSC` | 새 기준자료로 프로젝트 자료 갱신 | 매칭 `호환규정코드 / 시설코드 / 명칭·규격·단위 / 호환+명+규+단 / 명칭·단위 / 설정안함`; 명칭·단가·조달코드별 복사처/복사원 적용 |
+| `wM_JajeXLS` | 자재 기준자료를 XLS로 내보내거나 불러오기 | 방향과 주요 선택지 `미확인` |
+| `PM_iLWi`·`PM_iLWi_S` | 일위대가표 인쇄 원장을 구성 | 인쇄 전용 폼; 입력 칸 `미확인` |
+| `PM_JOONG`·`PM_JOONG2`·`PM_JOONG_L` | 중기목록·시간당중기사용료 인쇄 원장을 구성 | 일반·변형·가로형 구분 외 입력 칸 `미확인` |
+
+### 2.5 원가계산·제비율 — 6개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wM_KanJub` | 설계 제잡비를 계산하고 원가계산서를 만든다 | `원설계 / 1차변경 / 2차변경 / 3차변경`; `제잡비 원가계산방식 / 제잡비 표준시장방식`; 간접비·총공사비 절사 단위; `당초/변경 대비인쇄 / 변경분만 인쇄` |
+| `wM_KAN_RATE` | 제잡비 요율표를 조회·수정·저장·출력 | 상단 `수정 / 취소 / 저장 / 출력 / 종료 / 불러오기`; 요율표 선택 콤보; 실제 탭은 DFM §4 참조 |
+| `PM_KAN_RATE` | 제잡비 요율표 인쇄 | 공사규모 구간별 기초액·요율, 일반관리비 등 출력; 입력 화면 아님 |
+| `wM_GetAMT` | 내역에서 잡비 계산 기초금액을 불러온다 | `모두보기 / 소계(+=) / 계(+==) / 합계(+===) / 총계(+====) / 총합계(+=====)` |
+| `wM_KanJub_K` | 기성 제잡비 계산 | 집계수준 `소계`~`총합계 이상`; 부가세 `(0) 직접입력 / (1) 공급가액의 10% / (2) 재료비의 10% / (3) 재료비+산출경비의 10%`; 절사 단위 |
+| `PM_Won_A`·`PM_Won_A_C`·`PM_Won_A_L` | 공사원가계산서 출력 원장을 구성 | 일반·변경·가로형 구분 외 입력 칸 `미확인` |
+
+### 2.6 인쇄·출력 — 7개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `PM_Prt` | 전체 인쇄 메뉴와 출력 모양 설정 | 글꼴 `굴림체 / 궁서체 / 바탕체 / 돋움체`; 코드·호표·분류번호 등 인쇄 필드; `수량/단위 / 단위/수량 / 표준`; `일반 / 토개공 / 수자원공사`; `세로 / 가로`; `일반 / 산근` |
+| `PM_Prn_Ord` | 보고서 인쇄순서 지정 | `당초 설계 / 변경 설계 / 분할 설계 / 실적 공사 / 할증 내역 / 견적 내역 / 계약 내역 / 실행 예산 / 기성 내역 / 설계 변경 / 굴착·복구 / 굴착 변경` |
+| `PM_Sel_St` | 인쇄할 공종과 집계수준 선택 | `소계(+=) 이상`~`총합계(+=====)`; 방향 `아래로 / 위로` |
+| `wM_Sel_Prn` | 선택 영역·설계차수·표준시장단가 보정 후 인쇄 | `당초설계 / 변경설계 / 분할설계`; `7레벨공종이하 내역전체 / 해당레벨`; 비노무비 처리 3택; 노무비 끝전 보정 3택; `1차변경`~`8차변경` |
+| `PM_Nae*` 계열 | 총괄·설계·분할·관급·견적·계약 내역서 출력 | 일반·가로·변경·계약 등 변형; 세부 입력 칸 `미확인` |
+| `PM_Col_Dan*`·`PM_Col_X*` | 재료·노무·경비·중기·일위·산근 수량금액 집계표 출력 | 일반·가로·X 변형; 세부 입력 칸 `미확인` |
+| `PM_SanMok*`·`PM_Dan*` | 단가 목록·단가대비·단가산출 목록 출력 | 일반·가로·인쇄 변형; 세부 입력 칸 `미확인` |
+
+### 2.7 설정 — 5개
+
+| 화면 | 무엇을 하나 | 주요 입력 칸·선택지 |
+|---|---|---|
+| `wM_Set_Sys` | 계산 초기값과 표시 자리수 설정 | `KCD/ACD/JCD/ECD/BPN`: `0 / 1 / 2 자리`; `ZCD`: `2 / 3 자리`; 환율범위 `시간당중기사용료 단독 / 중기 / 대가 / 산근 / 내역 전체`; 노임계수 `터널 / 장대터널 / 펌프준설선 / GRAB준설선 / 버켓준설선` |
+| `wM_Set_Init` | 프로젝트 계산 초기값 설정 | 구체적인 탭·칸 `미확인` |
+| `wM_Set_JLab` | 직종·노임 관련 초기 설정 | 구체적인 칸 `미확인` |
+| `uM_XML_Info` | 공사원가 호환규정 XML 변환 설정 | 공사유형 `토목 / 건축 / 설비 / 전기 / 통신 / 조경 / 소방 / 국가유산수리공사` |
+| `wSrch_PL` | 프로젝트 DATA 검색 | 종류 `노무비 / 재료비 / 경비 / 중기비 / 일위대가 / 단가산출 / 일식·표준시장 / 내역서` |
+
+## 3. 화면 ↔ 출력 시트 30종
+
+`print_form_map.txt`의 export 연결과 19번 §3의 실제 시트명을 합쳤다. `PM_*`은 인쇄용 폼이며 편집 화면에서 직접 호출되는지는 정적 자료만으로 확인되지 않은 경우가 있다.
+
+| 화면·폼 계열 | 실제 출력 시트 |
+|---|---|
+| `wM_KanJub` → `PM_Won_A*` | 공사원가계산서 |
+| `wBoq` → `PM_Nae*` | 설계내역서 · 착공내역서 · 총괄설계내역서 · 총괄내역서 |
+| `wBoq`/변경 내역 → `PM_Nae*` 또는 `CHANGE_*` | 설계변경내역서 · 설계변경금액대비표 · 설계변경증감대비표 |
+| `wM_Edit_iLWi` → `PM_iLWi*` | 일위대가표 |
+| `wM_Edit_San` → `Calq_San`·`Edit_SanKun` | 단가산출근거 |
+| `wM_JabPum`/중기 원장 → `PM_JOONG*` | 중기사용료 |
+| `wM_Boxa` 또는 단가비교 → `PM_Col_Dan*` | 자재단가대비표 |
+| `wM_Set_Sys` 관련 설정 출력 | 환율및기초자료 · `〓 INITIAL 〓` — 정확한 `PM_*` 호출은 `미확인` |
+| `wM_JabPum` → `PM_SanMok*` | 재료비목록표 · 노무비목록표 · 경비목록표 · 일식견적목록표 |
+| 일위대가 원장 → `PM_SanMok*` | 일위대가목록표 |
+| 단가산출 원장 → `PM_SanMok*` | 단가산출근거목록표 |
+| 중기 원장 → `PM_JOONG*` | 중기목록표 |
+| 내역 집계 → `PM_Col_Dan*` | 재료비수량금액집계표 · 노무비수량금액집계표 · 경비수량금액집계표 |
+| 중기 집계 → `PM_Col_Dan*` | 중기시간금액집계표 |
+| 일위대가 집계 → `PM_Col_Dan*` | 일위대가수량금액집계표 |
+| 단가산출 집계 → `Calq_San`·`Edit_SanKun`·`PM_Col_Dan*` | 단가산출근거수량금액집계표 |
+| 일식견적 집계 → `PM_Col_Dan*` | 일식견적수량금액집계표 |
+| 인쇄 메뉴의 보고서 목록 | `〓 목 차 〓` · `※※안내※※` — 생성 폼 `미확인` |
+
+30종은 위 대응에 모두 들어간다. 다만 `환율및기초자료`, `〓 INITIAL 〓`, `〓 목 차 〓`, `※※안내※※`의 정확한 생성 폼 **4개 연결은 미확인**이다.
+
+## 4. DFM 3벌의 실제 배치
+
+### 4.1 `TWM_KANJUB.dfm` — 제잡비 계산 입력 화면
+
+- 상단 고정 패널 다음에 본문 `TPageControl(Pg_Ctrl)`이 놓인다.
+- 상단 칸 차례는 기본값 설정, 차수 선택, 계산방식, 요율, 출력, 변경/계산, 종료 계열이다. 확인되는 콤보는 `Cmbx_PORD1_H` → `cBx_K_JeolSa` → `cBx_Chasu` → `cBx_W_Type` 순이다.
+- `cBx_Chasu`: `원설계 / 1차변경 / 2차변경 / 3차변경`; `cBx_W_Type`: `제잡비 원가계산방식 / 제잡비 표준시장방식`.
+- 본문 탭은 아래쪽 탭바(`TabPosition=tpBottom`)이고 여러 줄 탭(`MultiLine=True`)이다. DFM에서 `TbSh_T`, `TbSh_TA` 등 원가 형식별 탭 객체가 확인된다. 탭 캡션 전체와 탭별 항목 수는 `미확인`이다.
+- 각 탭 안은 `TScrollBox`로 구성되어 긴 제잡비 항목을 세로로 스크롤한다.
+
+### 4.2 `TWM_KAN_RATE.dfm` — 요율 조회·편집 화면
+
+- 상단 고정 도구막대: `수정(&E)` → `취소(&C)` → `저장(&S)` → `출력(&P)` → `종료(&Q)` 순이며 `불러오기` 버튼과 요율표 선택 콤보가 함께 있다.
+- 본문은 `TPageControl(Pg_Ctrl)`이며 탭바가 아래쪽에 있다. 확인되는 첫 탭 객체는 `Tab_Rn`이다.
+- 탭 안은 흰색 `TScrollBox`와 여러 요율 그리드로 구성된다. 확인되는 묶음은 고용 관련 요율(`rGrd_Rate_Kobo`), 산업안전 관련 요율(`rGrd_Rate_Anjun`) 등이다.
+- 그리드 열은 공사규모 구간과 `요율`, `기초액`, `% + 천원` 형식을 함께 가진다. 즉 한 화면에서 단순 단일요율뿐 아니라 규모별 기초액 가산식도 편집한다.
+- 전체 탭 캡션과 모든 그리드의 화면상 정확한 순서는 바이너리 DFM 문자열만으로 복원되지 않아 `미확인`이다.
+
+### 4.3 `TPM_KAN_RATE.dfm` — 요율표 인쇄 화면
+
+- 편집 위젯이 아니라 `THRPage` 기반 보고서 한 장이다. `ReportHeader` 뒤에 요율표가 이어진다.
+- 제목·구간 라벨 → 금액 구간 → 기초액 → 요율 순으로 열이 반복된다.
+- 확인되는 구간 예시는 `10억~50억 미만`, `70억~120억`이며 표시 형식은 `00.00 %` 또는 `(#,0 천원 + …)`이다.
+- `일반관리비` 등 항목별 표가 인쇄 좌표에 고정 배치된다. `TWM_KAN_RATE`의 편집 그리드를 종이용 규모구간 표로 펼친 구조다.
+
+## 5. B08·B09 화면 구조에 주는 근거
+
+```text
+수량산출서(wQtyList/uM_ConQTY)
+  → 내역 입력(wBoq)
+  → 일위대가·단가산출 편집
+  → 기준자료(단가·노임·중기)
+  → 제잡비 계산(wM_KanJub)
+  → 인쇄 메뉴(PM_Prt)에서 30종 시트 선택
+```
+
+- B08 근거: 수량산출서는 코드 종류로 필터한 별도 화면이고, 내역서와 분리되어 있다.
+- B09 근거: 직접비 편집, 기초단가, 일위대가·단가산출, 제잡비 요율, 출력이 각각 별도 화면이며 마지막에 인쇄 메뉴가 묶는다.
+- 제잡비 입력 화면과 요율 관리 화면도 분리된다. 요율 관리 화면은 수정·저장·출력의 독립 흐름을 가진다.
+- 출력은 계산 화면을 그대로 인쇄하지 않고 `PM_*` 보고서 폼을 따로 거친다.
+
+## 6. 미확인
+
+화면 단위 미확인 **10개**:
+
+1. `wM_From_XLS`의 열 매핑·불러오기 옵션
+2. `wSameCode`의 동일 코드 처리 선택지
+3. `uM_ConQTY`의 변환 방향·연결 키
+4. `wM_Edit_USER`의 사용자식 편집 범위
+5. `wM_iLWi_San`의 조회·편집 경계
+6. `wM_JajeXLS`의 입력·출력 방향
+7. `wM_Set_Init`의 탭과 칸
+8. `wM_Set_JLab`의 직종·노임 설정 칸
+9. `TWM_KANJUB`의 전체 탭 캡션·항목 수
+10. `TWM_KAN_RATE`의 전체 탭 캡션·그리드 순서
+
+출력 연결 미확인 **4개**: `환율및기초자료` · `〓 INITIAL 〓` · `〓 목 차 〓` · `※※안내※※`의 정확한 생성 폼.
+
+이 문서는 화면 구조 근거만 정리한다. Aislo B08·B09의 구현안이나 화면 설계는 포함하지 않는다.