Pier_v1/도면작성/REFERENCE_PARITY.md

# 기준 일반도 재현 현황 — 2026-11-04

기준: `[교각-T 형] 01 일반도_20260619.dwg`. 원본은 보존하고, 기존 읽기 모듈로 변환된 객체를 분석했다. 상세한 객체별 색상 분포/레이어/폰트는 `reference-style-analysis.json`에 기록했다.

## 이번에 실제 반영한 변경

- CS-CONC-MAJR: ACI 4(시안), CS-DIML/CS-XXXXCS-CENT/CS-SYMB: ACI 1(빨강), CS-DIMT 및 표 문자: ACI 3(초록). 기존 임의 네이비 색상을 제거했다. 흰 종이 미리보기의 ACI 7은 검정으로 표시한다.
- DXF 레이어의 선가중치는 원본의 BYDEFAULT(-3)를 따른다. 원본 CTB가 제공되지 않았으므로 출력 굵기가 같다고 단정하지 않는다. 화면의 구별용 선굵기와 CAD의 원본 선가중치는 구분한다.
- A-ISONS01, A-HIDDN01, A-CENTR01, CENTER의 원본 패턴을 등록했다. 구조 외형/치수/기호 및 숨은선에 대응한다.
- 원본의 주된 Standard 폰트 gulim.ttc를 생성 문자에 적용했다. TB_TEXT, TB_WBTXT, ST1, 굴림체, 돋음 스타일과 원본 폰트 파일명도 등록했다. 실제 설치되지 않은 글꼴은 CAD 대체가 발생할 수 있다. 글꼴 파일을 임의 복사하지 않았다.
- 표 문자/격자는 CS-TABL-TEX2 / CS-TABL-LIN2로 분리했다. 치수 문자와 치수선도 CS-DIMT / CS-DIML로 분리한다.
- 콘크리트 면 채움에는 원본에서 다수 확인된 ACI 254의 회색(#cccccc)을 적용했다. 아이소메트릭의 면별 음영은 형상 가독성을 위해 유지했다.
- 도곽 CXBLKA1에서 추출한 실제 벡터·로고·38개 속성·NOTE 21줄과 기존 편집 기능을 유지했다. 기존 현재 모델 데이터, 치수, EL, 받침 번호 및 제원표를 사용한다.

## 아직 동일하지 않은 항목

추가 구현: 원본 HS_050의 점(_Dot) 끝기호, 치수 문자 3mm, 보조선 간격 5mm, 치수 레인 9mm를 적용했다. 실제 CZSECMU-ARW2의 선·삼각 채움·문자 좌표를 모듈화해 단면 절단선에 적용했다. 기초 평면 말뚝 중심 마크와 실제 지름·본수 지시선을 추가했다. 원본 도곽 개별 객체의 CAD 레이어·색상·선가중치를 추출해 보존한다. 형상 차이에 따른 치수 레인의 실제 위치는 자동 배치되므로 원본 좌표의 복제는 아니다. 일반/표 2.5mm 및 EL 2.6mm는 가독성 기준을 유지한다.

원본은 여러 교각과 블록/개별 객체 색상 재정의가 섞여 있어 레이어 기본색만으로 모든 객체가 같아지지는 않는다. 도곽은 PZ_CXBLKA1 BLOCK으로 재구성하고 표제란 38개 태그를 ATTDEF/ATTRIB으로 저장한다. 빈 값도 속성으로 보존하므로 CAD 속성 편집이 가능하다. 원본 로고/곡선의 허용오차 폴리라인화는 유지한다. 모델에 없는 모따기/변단면 기초/받침 제원은 미확인으로 유지한다.

## 지질주상도 확장

`geology-extension.ts`에 출처가 있는 주상도 입력과 독립 용지 영역을 받는 인터페이스를 추가했다. 데이터가 없으면 패널을 만들지 않는다. 실제 연결 시 별도 영역 또는 추가 장에 배치하고 기존 점유 영역 검사에 포함해야 한다. 현 단계에서 허구의 주상도나 빈 공간을 채우는 그림을 생성하지 않는다.

## DWG 제한

이전 내보낸 DWG가 사용자 CAD에서 열리지 않았다는 보고가 있다. LibreDWG 재읽기 통과는 실제 AutoCAD 호환성 보증이 아니다. 이번 산출물도 내부 왕복 검증과 CAD 직접 열기 검증을 구분해야 한다. 실제 사용 CAD 이름/버전/오류 문구 또는 정상 DWG writer가 확인되기 전까지 **AutoCAD에서 열림·편집 가능 검증 완료라고 판정하지 않는다.** 원본 DWG를 변환 템플릿으로 덮어쓰지 않는다.

## 검증

도면작성 테스트 14개 통과, 타입 검사 통과. 마지막 스타일 변경 후 원시 CAD 생성 테스트를 다시 통과했다. 실제 DWG 직접 열기와 CTB를 적용한 색상·굵기 인쇄 비교는 미완료다. 기존 3D/철근/재료표 코어는 수정하지 않았다.


## 2차 구현 변경 파일

`reference-symbols.ts`: 원본 단면 절단 기호. `dimension-graphics.ts`, `cad-style.ts`: 원본 점 치수 및 여백. `drawing.ts`: 실제 말뚝 중심·지름/본수 리더. `dxf.ts`: 도곽 BLOCK/ATTDEF/ATTRIB, _Dot 블록 및 네이티브 치수 참조. `extract_template.py`, `reference-template.ts`, `types.ts`, `svg.ts`: 원본 도곽 개별 객체의 CAD 색상/레이어 보존. `template.ts`: 빈 표제란 필드 보존. `quality-layout.ts`: 간섭 검사 캐시. `dwg_export.py`, `verify_dxf.py`: BLOCK/ATTRIB 내용과 치수 점 기호 재읽기 검사.

표제란 38개 속성은 CAD 원시 객체 재읽기로 확인한다. DWG 변환 후에도 블록 정의·속성값·삽입 좌표가 유지되는지 검사한다. 원본 값이 없는 시공 상세·받침 제원 및 지질주상도는 생성하지 않는다. 사용 CAD에서의 직접 열기 검증은 별도 미완료 항목이다.


최종 검사에서 PZ_CXBLKA1의 ATTDEF/ATTRIB 38개, 빈 속성 유지, Paper Space 속성 소유 관계, 네이티브 DIMENSION의 _Dot 참조를 추가 확인했다. 원본 블록 좌표와 별도로 실제 치수와 표고는 현재 모델을 유지한다. 치수 문자 확대/절단 기호 때문에 달라진 점유 영역은 자동 축척·배치에 반영한다. 전체 일괄 투영 검사는 BSP 면 가림 처리와 병행 테스트 시간을 고려해 120초 한도로 실행한다.

실제 출력: `output/reference-parity-attributes/운곡교_P1_일반도.dwg`. 원본 모델 49개 네이티브 치수와 블록/속성의 왕복 일치, DXF 감사 오류/수정 0건을 확인했다. DWG 재읽기에서는 기존 재질 사전 placeholder 3개 정리 경고가 유지되므로 무결한 AutoCAD 출력으로 단정하지 않는다.


최종 회귀 검사: 도면작성 14개 통과, 샘플 교각 63개 간섭 0건/원본 투영 형상 변경 0건. 전체 538개 중 534개 통과, 기존 코어 실패 4건(axis, bearing-coordinate-frame, integrated-block, validate-and-foundation)은 유지한다. 타입 검사·빌드 통과. 커밋하지 않았다. 실제 AutoCAD 열기/CTB 출력 검사는 미실시다.