Pier_v1/수량산출/docs/DASHBOARD_REPORT.md

교각 수량산출 대시보드 개선

변경 파일과 역할

• workspace.ts: 기존 연결 API를 유지한 화면 조립, 교각 선택, 저장, 재계산, Excel 출력, 전체 미리보기 전환.
• workspace.css: 화면 범위를 제한한 3열 배치, 상태/태그/표/반응형 스타일.
• dashboard-types.ts: 화면 선택 상태와 실제 원본 행 기반 표시 자료.
• input-panel.ts: 입력 그룹 아코디언, 필수 진행률, 누락 항목 이동, 자동/직접/Excel 기본값 구분.
• results-panel.ts: 요약 카드, 부재/공종/자재 보기, 검색, 접기, 선택 행과 상태 표시.
• review-panel.ts: 미니 문서 뷰어, 전체화면, 선택 항목 산식·입력값·대입식·결과.
• excel-preview.ts: 기존 원본 미리보기의 축소 모드, 페이지 표시, 선택 셀 강조와 이동.

사용 흐름

교각 선택 → 입력 그룹 확인 및 누락 보완 → 원본 기준 검토 → 재계산 → 중앙 행 선택 → 우측 원본 셀/산식 확인 → Excel 출력.

자동값은 읽기 전용이며 직접값은 교각별 기존 저장 필드를 사용한다. Excel에서 가져온 시험 횟수·규격은 별도 출처 태그로 구분한다. 진행률의 분모는 실제 계산에 필요한 항목을 기준으로 하며 시안의 예시 숫자를 고정하지 않는다.

요약은 원본 W60 콘크리트, W67 철근, W50W56 거푸집, W6W29 토공을 사용한다. 집계는 같은 단위의 원본 항목만 합산하며 콘크리트와 타설 작업을 중복 합산하지 않는다. 미산정 결과는 0으로 대체하지 않는다.

기존 기능 유지

이번 UI 변경에서 계산 엔진, 모델 매핑, 원본 분석, Excel 출력 서버/패키지 보존 로직은 변경하지 않았다. 기존 재료표 메뉴, 교각별 직접값 저장, 형상 변경 재계산 상태, 출력 완료 조건을 유지한다. 선택 행은 실제 원본 셀로 연결되며, 원본 산식과 실제 적용식이 다르면 함께 확인할 수 있다.

검증

• TypeScript 검사 통과.
• 수량산출 단위 테스트 10개 통과.
• Vite 빌드 통과. 기존 단일 번들 크기 경고는 남아 있다.
• 실제 운곡교 샘플: 1920×1080 / 1366×768에서 세 패널이 화면 안에 배치되는지 확인.
• 누락 필드 이동, 입력 저장과 교각 전환, 재계산 변경 강조, 53개 원본 행, 검색, 공종/자재 보기 확인.
• 행 선택에 따른 산식 상세와 원본 셀 강조 연동, 13시트 전체 미리보기, 전체화면, Excel 다운로드 확인.
• 기존 재료표 화면 정상 표시, 브라우저 pageerror 0건.
• 근거: dashboard-verification.json, 검증 출력: ../outputs/verification/운곡교P1_대시보드검증.xlsx.

검증 출력의 누락 현장 조건은 원본 예시값으로 입력한 테스트 조건이며 현장 확정 수량이 아니다. 이번 검증은 Microsoft Excel 앱에서 직접 열기/재계산까지 확인한 결과는 아니다.

시안과 차이 및 기존 한계

• 시안의 6페이지 예시 대신 실제 원본 13시트를 표시한다. 원본 표지·양식의 색상과 배치는 유지한다.
• 원본에 없는 입력변수나 공제조건은 새 계산 조건으로 만들지 않았다. 원본 고정 기준은 검토 영역에서 확인한다.
• 작은 미리보기는 원본 전체 폭을 축소하므로 정밀 검토에는 확대 또는 전체화면을 사용한다.
• 지원 형상 및 원본 수식 불일치에 대한 기존 검토 제한은 유지한다. 모든 교각 형식의 설계 검증이 완료되었다는 의미는 아니다.