Pier_v1/RAG/design-model-box-sample_2/docs/OBJECT_MODEL_CONTRACT.md

객체별 형상·철근 처리 계약

공통 순서

원본 도면 → 물리 객체 식별 → 콘크리트 형상 확정 → 객체별 배근 근거 판독 → 철근 배치 → 검증된 부분 표시.

• 기존 모델의 철근 좌표는 회귀 비교 대상이지 생성 입력이 아니다.
• 원본의 도면 영역, 치수 문자, 치수선, 리더, 철근상세, 재료표를 함께 기록한다.
• 생성기는 작업 ID나 파일명에 따라 분기하지 않는다.

명칭과 물리 객체

브라켓의 저장 형식은 bracket 하나다. 예전 approach_bracket 값은 입력/저장 경계에서 단방향 변환한다. 형상·철근 생성기가 두 종류로 취급하지 않는다. 변환은 ID, 좌표, 메시, 철근 경로를 변경하지 않는다.

블럭, 좌·우, 시·종점은 물리 occurrence를 식별하는 정보다. 동일 마크가 여러 객체에 있어도 하나로 합치지 않는다. 인식하지 못한 종류와 소유 객체는 장부에 명시하며 다른 객체에 임의 귀속하지 않는다.

형상과 철근 분리

memberModel.objects[물리 ID]에 두 항목을 분리한다.

• geometry: 원본 콘크리트 객체 ID와 사용한 뷰. 좌표의 사본을 별도로 만들어 원본과 어긋나게 하지 않는다.
• reinforcement: 해당 객체에 속한 그룹 ID와 그룹 내 실제 경로 인덱스. 그룹 마크가 아니라 occurrence_instance_ids로 연결한다.

이 장부는 검증 승인서가 아니다. 제작 상세, 피복, 길이, 수량 및 접합 검사는 따로 실행한다.

벽체와 슬래브 독립

슬래브 평면이 경사라는 이유로 벽체 배치를 중단하지 않는다. 벽체 자체의 형상에서 양 면의 설치 범위를 구하고, 벽체도의 좌·우 객체 제목과 양단 치수를 판독한다.

내·외측이 나뉜 벽체도는 실제 공유 분할선을 사용한다. 이를 도면의 기하학적 중점이라고 가정하지 않는다. 반대 면에 표시한 양단 치수는 동일 벽체의 투영 범위와 양 치수 지시점의 동일 변위를 확인한 뒤 연결하며 인쇄된 치수값은 바꾸지 않는다.

철근 끝점과 치수 지시점의 그래픽 대응에는 해당 행의 직경을 사용한다. 대응 잔차를 근거에 기록하고, 실제 배치는 그래픽 끝점이 아니라 도면의 명시 치수로 한다. 단면 위치·수량, 3D 내부 검사, 도면 길이 범위, 실제 그려진 반쪽 벽체의 구배를 다시 검사한다.

회귀와 게시

수치·메시 표현 차이로 인한 중복/오판 방지

• 치수로 계산한 CAD 축척은 일반부와 경사부 모두 같은 소수점 정밀도로 정규화한다. 부동소수점 오차로 같은 도면 뷰를 두 번 세지 않는다. 다른 도면 영역이나 다른 외곽선은 합치지 않는다.
• 명시된 정점·면 메시가 있으면 표고 조회와 내부 판정 모두 그 메시를 기준으로 한다. 오래된 footprint 표고 배열을 메시보다 우선하지 않는다.
• 전단키 등 오목한 단면에는 볼록 다면체의 반공간 검사를 적용하지 않는다. 실제 면의 경계로 삼각분할하고 내부/빈 공간을 구분한다.
• 철근 경로의 객체 귀속은 몇 개의 고정 샘플만으로 결정하지 않는다. 실제 단면 경계면에서 경로를 분할해 좁은 접합부도 검사한다. 경계면 연장선은 검사 지점만 추가하며 콘크리트나 정착 관계를 만들어내지 않는다.
• 메시 기반 수정은 콘크리트 정점을 이동하지 않는다. 철근의 기존 표고를 교체할 때에는 원본 경로·직경·평면 위치·본수와 새 호스트 내부 검사 결과를 별도로 확인하고 이전 파일을 보관한다.

재생성에는 저장된 철근과 이전 설치선 좌표를 입력하지 않는다. 기존 모델과 비교할 때 좌표·직경·본수·소유 객체를 확인한다. 이름 스키마 변환과 형상 변경을 구분해서 기록한다.

부분 게시 시 기존 그룹은 유지하고 검사를 통과한 새 그룹만 추가한다. 제작 이음 분할 등이 미확정이면 검토용 상태를 유지한다. 기존 모델을 재현하지 못한 항목이 있으면 전체 회귀 통과라고 보고하지 않는다.