diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..2933fe5 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,43 @@ +# 프로젝트 지침: 도면 기반 웹 3D 모델 + +## 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` 레이어의 구조물선과 해당 치수가 일치하는지 확인한다. +- 두 레이어의 표기 치수가 부족하면 실제 윤곽선을 측정해 모델링한다. + +## 2. 모델링 값 기록 +- 대상별 위치, 길이, 폭, 높이, 두께, 간격, 경사 등 모델에 필요한 값을 표로 정리한다. +- 각 값에 근거 도면 번호와 도면 안의 위치를 함께 기록한다. +- 각 값을 다음 상태 중 하나로 표시한다: `도면 명시값`, `계산으로 도출한 값`, `추정값`, `확인 필요`. +- 축척으로 재어 얻은 값은 도면에 적힌 치수와 혼동되지 않도록 별도로 표시한다. + +## 3. 오류 및 정보 부족 검토 +- 도면 간 치수·위치·높이의 불일치를 확인해 기록한다. +- 누락되었거나 판독하기 어려운 정보를 목록으로 만든다. +- 형상과 배치에 영향을 주는 치수는 임의로 결정하지 않고 사용자 확인을 요청한다. + +## 4. 모델 구성 및 생성 +- 단면도의 치수선을 제외한 구조물선을 빠짐없이 모델링에 반영한다. +- 부재를 개별 선택·숨김·수정할 수 있도록 객체를 나누고 알아보기 쉬운 이름을 붙인다. +- 도면 개정 때 치수와 배치를 쉽게 바꾸도록 값을 코드와 모델 구조에서 관리하기 쉽게 구성한다. +- 먼저 주요 형상과 전체 배치를 만들고, 이후 세부 형상을 추가한다. + +## 5. 웹 3D 뷰어 +- 마우스 또는 터치로 회전·확대/축소·이동할 수 있게 한다. +- 전체 보기와 평면·정면·측면 보기를 제공한다. +- 객체를 선택하면 이름과 주요 치수를 보여준다. +- 객체별 표시/숨김 기능을 제공한다. +- 추정값 또는 확인 필요 항목으로 만든 형상은 화면에서 명확히 구분한다. +- 기본 모델 보기와 표면 명암·배경·그림자를 적용한 렌더링 보기를 전환할 수 있게 한다. 렌더링 보기는 도면 검토용 시각화이며 실사 렌더링으로 오해하지 않도록 표시한다. + +## 6. 검증 및 결과 보고 +- 주요 치수, 기준 높이, 부재 개수와 배치를 원도면과 대조한다. +- 검증 완료 항목과 미검증 항목을 나누어 보고한다. +- 도면과 다르게 표현한 부분, 추정한 부분, 생략한 부분을 기록한다. +- 실행 방법과 다음 수정 때 변경할 항목을 안내한다. +- 변경 후 가능한 실행·검증을 수행하고, 확인하지 못한 부분을 명시한다.