- `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>
2.6 KiB
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. 기능 및 도메인 모델 검증
- DB SSOT 구현:
b08_workspaces,b08_categories,b08_quantity_items,b08_unit_prices,b08_quantity_revisions,b08_calculation_runs테이블 기반 Raw SQL로 프로젝트 수량, 보정이력, 단가, 버전을 관리.
- STmate 코드 및 내부 ID 매핑 분리:
external_code와 내부 UUIDid를 명시적으로 분리하여 STmate/STC 외부 데이터 대조 구조 확보.
- 수량 보정 이력 및 사유 보존:
patch_quantity()에서 보정수량 변경 시adjustment_reason을 필수 검증하며b08_quantity_revisions테이블에 사유 및 변경 이력을 영구 보존.
- 단계별 직접공사비 계산 및 기준값 대조:
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 연동 제공.
- 미확정 제경비 명시적 차단:
- 추정 계산 없이 입력 스냅샷과 확인된 직접공사비 대조 항목에 한해서만 산출 결과를 제시하도록 제약 처리.
3. 종합 결론 및 조치사항
- 검증 결과: PASS (B08 재구축 계획 명세 및 완료 조건 8종 모두 완벽 준수)
- 조치 사항:
PLAN.md에서 완료된# B08 재구축 작업 계획 (2026-07-25)섹션을 Cut하여docs/raw/plans/2026-07-25_plan_b08_rebuild.md로 이관.PLAN.md최신화 완료.