# 프로젝트 지침: 도면 기반 웹 3D 모델

## 기본 원칙
- 사용자와 주고받는 설명 및 웹 화면 문구는 한국어로 작성하고, 개발 초보자도 이해하기 쉬운 용어를 쓴다.
- 작업 전 기존 폴더 구조와 코드를 확인하고 필요한 부분만 수정한다. 큰 구조 변경이 필요하면 이유와 범위를 먼저 설명한다.
- 비밀번호, API 키 등 민감한 정보를 코드나 Git 기록에 포함하지 않는다.
- 도면 첨부 후에는 분석, 주요 형상 모델링, 세부 형상, 뷰어 기능, 검증 및 문서화처럼 검토 가능한 작업 단위로 나누어 진행한다. 각 단위가 완료되고 변경 내용을 확인한 뒤 해당 변경만 Git 커밋으로 저장한다.
- 커밋 메시지는 변경 내용을 쉽게 알 수 있도록 한국어로 작성한다. 사용자가 요청한 각 작업 단위별 커밋을 만들되, 원격 저장소로 푸시하거나 공개하지 않는다.
- 도면 파일이 없거나 판독이 불가능하면 그 사실을 알리고, 도면 근거가 필요한 형상·치수를 임의로 확정하지 않는다. 정보가 부족해도 진행 가능한 부분은 먼저 진행하고 확인 항목과 나눈다.

## 1. 도면 분석
- 평면도,상부평면도,종단면도,단면도A-A,단면도B-B,측구상세도를 참고한다. 
- 평면도·종단면도·단면도·상세도에서 같은 대상을 어떤 근거로 연결해 읽었는지 설명한다.
- 모델은 평면도상의 선형중심선과 종단면도와 단면A-A, 단면B-B를 기준으로 한다.
- 평면도·종단면도·단면도·상세도의 스케일값을 확인한다.
- 평면도의 중심선형의 시점과 단면도A-A, 종점과 단면도B-B의 중심 기준점 EL값을 일치시킨다.
- 종단면도의 시종점 벽체상단 EL값과 단면A-A와 단면B-B의 벽체 상단의 EL값이 동일한지 확인한다.
- 실제 모델 윤곽선인 CS-CONC-MAJR,CS-CONC-MINR레이어를 가진 구조물선관 그에 해당하는 치수가 일치하는지 확인한다.
- CS-CONC-MAJR,CS-CONC-MINR 이 두레이어의 표기 치수가 부족한 경우 실제 윤곽선을 측정하여 모델링한다.

## 2. 모델링 값 기록
- 대상별 위치, 길이, 폭, 높이, 두께, 간격, 경사 등 모델에 필요한 값을 표로 정리한다.
- 각 값에 근거 도면 번호와 도면 안의 위치를 함께 기록한다.
- 각 값을 다음 상태 중 하나로 표시한다: `도면 명시값`, `계산으로 도출한 값`, `추정값`, `확인 필요`.
- 축척으로 재어 얻은 값은 도면에 적힌 치수와 혼동되지 않도록 별도로 표시한다.

## 3. 오류 및 정보 부족 검토
- 도면 간 치수·위치·높이의 불일치를 확인해 기록한다.
- 누락되었거나 판독하기 어려운 정보를 목록으로 만든다.
- 형상과 배치에 영향을 주는 치수는 임의로 결정하지 않고 사용자 확인을 요청한다.

## 4. 모델 구성 및 생성
- 단면도의 치수선을 제외한 구조물선을 누락없이 모델링에 반영한다.
- 부재를 개별 선택·숨김·수정할 수 있도록 객체를 나누고 알아보기 쉬운 이름을 붙인다.
- 도면 개정 때 치수와 배치를 쉽게 바꾸도록 값을 코드와 모델 구조에서 관리하기 쉽게 구성한다.
- 먼저 주요 형상과 전체 배치를 만들고, 이후 세부 형상을 추가한다.

## 5. 웹 3D 뷰어
- 마우스 또는 터치로 회전·확대/축소·이동할 수 있게 한다.
- 전체 보기와 평면·정면·측면 보기를 제공한다.
- 객체를 선택하면 이름과 주요 치수를 보여준다.
- 객체별 표시/숨김 기능을 제공한다.
- 추정값 또는 확인 필요 항목으로 만든 형상은 화면에서 명확히 구분한다.
- 기본 모델 보기와 표면 명암·배경·그림자를 적용한 렌더링 보기를 전환할 수 있게 한다. 렌더링 보기는 도면 검토용 시각화이며 실사 렌더링으로 오해하지 않도록 표시한다.

## 6. 검증 및 결과 보고
- 주요 치수, 기준 높이, 부재 개수와 배치를 원도면과 대조한다.
- 검증 완료 항목과 미검증 항목을 나누어 보고한다.
- 도면과 다르게 표현한 부분, 추정한 부분, 생략한 부분을 기록한다.
- 실행 방법과 다음 수정 때 변경할 항목을 안내한다.
- 변경 후 가능한 실행·검증을 수행하고, 확인하지 못한 부분을 명시한다.