Files
Aislo/docs/raw/verification/2026-07-25_verify_b08_rebuild.md
T
eomsangdonandClaude Opus 5 eb30b774f8 chore(docs): docs 폴더 git 추적 전환 · PLAN·OWNERS 최상위 이관
- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록)
- `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록
  — 창끼리 공유하되 저장소에는 안 올리는 장부
- 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠)
- graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 18:19:07 +09:00

2.6 KiB

코드 검증 보고서 — B08 재구축 작업 (2026-07-25)

1. 검증 개요

  • 검증 일시: 2026-07-25
  • 검증 대상: B08_wf5_Quantity 물량·견적 모듈 전면 재구축
  • 검증 기준: docs/raw/PLAN.md 내 # B08 재구축 작업 계획 (2026-07-25) 명세 및 완료 조건 8종

2. 세부 검증 결과

2.1. 변경 범위 및 파일 700줄 제한 검증

  • 변경 범위 검증: 모든 신규/수정 파일이 B08_wf5_Quantity 폴더 내부에만 존재하며, 외부 소스코드 오염이 없음.
  • 700줄 이하 제한 준수:
    • B08_wf5_Quantity_Repository.py: 138줄
    • B08_wf5_Quantity_Import.py: 130줄
    • B08_wf5_Quantity_Store.ts: 120줄
    • B08_wf5_Quantity_Router.py: 95줄
    • B08_wf5_Quantity_UI_Quantity.ts: 110줄
    • B08_wf5_Quantity_UI_Style.css: 145줄
    • 기존 2,068줄 대형 파일(B08_wf5_Quantity_Template.ts)이 20개의 기능별 세분화 모듈로 완전 분리 재구성되어 전 파일 700줄 제한을 완벽히 만족.

2.2. 기능 및 도메인 모델 검증

  1. DB SSOT 구현:
    • b08_workspaces, b08_categories, b08_quantity_items, b08_unit_prices, b08_quantity_revisions, b08_calculation_runs 테이블 기반 Raw SQL로 프로젝트 수량, 보정이력, 단가, 버전을 관리.
  2. STmate 코드 및 내부 ID 매핑 분리:
    • external_code와 내부 UUID id를 명시적으로 분리하여 STmate/STC 외부 데이터 대조 구조 확보.
  3. 수량 보정 이력 및 사유 보존:
    • patch_quantity()에서 보정수량 변경 시 adjustment_reason을 필수 검증하며 b08_quantity_revisions 테이블에 사유 및 변경 이력을 영구 보존.
  4. 단계별 직접공사비 계산 및 기준값 대조:
    • B08_wf5_Quantity_Calculator.ts 및 Engine.py에서 재료비·노무비·경비 및 직접공사비를 입력 스냅샷과 규칙 버전에 따라 렌더/계산.
    • B08_wf5_Quantity_UI_Reconciliation.ts에서 기준금액(재료비 194,234,417원, 노무비 346,800,554원, 경비 169,324,165원, 직접공사비 710,359,136원) 대조 UI 및 API 연동 제공.
  5. 미확정 제경비 명시적 차단:
    • 추정 계산 없이 입력 스냅샷과 확인된 직접공사비 대조 항목에 한해서만 산출 결과를 제시하도록 제약 처리.

3. 종합 결론 및 조치사항

  • 검증 결과: PASS (B08 재구축 계획 명세 및 완료 조건 8종 모두 완벽 준수)
  • 조치 사항:
    1. PLAN.md에서 완료된 # B08 재구축 작업 계획 (2026-07-25) 섹션을 Cut하여 docs/raw/plans/2026-07-25_plan_b08_rebuild.md로 이관.
    2. PLAN.md 최신화 완료.