# 토치 시각 교정 명세서 v1 (CEO 스크린샷 데이터화)
> 작성: 2026-07-03 | 작성 주체: 챗 클로드 (CEO 스크린샷 7장 + 실물 사진 3장 판독)
> 대상: 클로드 코드 — 이 문서와 §0의 이미지 파일을 직접 열어 판독한 뒤 작업하라.
> 원칙: 이 문서의 "판정 기준"을 통과해야 완료. 숫자 검증만으로 완료 선언 금지 —
>       반드시 본인이 캡처를 열어 눈으로 대조하고, 최종 합격은 CEO 화면 판정.

---

## §0. 참조 이미지 (CEO가 아래 폴더에 저장한다)

폴더: `E:\도진팩토리\3D스캔및티칭시스템\shots\ceo_feedback\`

| 파일명 | 내용 | 용도 |
|---|---|---|
| real_wrist_closeup_1.png | 실물: 손목~플랜지~쇼크센서 클로즈업 (청동 플랜지) | 비례·밀착 기준 |
| real_wrist_closeup_2.png | 실물: 같은 부위 다른 각도 | 비례 교차확인 |
| real_torch_full.png | 실물: 토치 전체 (손목부터 노즐까지 세로) | 전체 실루엣 기준 |
| viewer_torch_full.png | 뷰어 현재: 같은 구도 전체 | 현재 상태 |
| viewer_flange_attached_closeup.png | 뷰어 현재: 손목~플랜지 클로즈업 | 결함 D1·D2 확인 |

**규약(영구): 앞으로 CEO의 화면 판정 스크린샷은 전부 이 폴더에 저장된다.
작업 전 폴더를 확인하고, "CEO가 뭘 봤는지"는 요약 전달이 아니라 원본 이미지를 직접 열어 판독한다.**

---

## §1. 확정 치수 (CEO 실측 — 변경 금지)

| 항목 | 값 | 출처 |
|---|---|---|
| 플랜지면 → 노즐 끝 | 525 mm | CEO 줄자 실측 = TOOL0 크기 525.2 일치 |
| 와이어 돌출 (노즐→와이어끝) | 15 mm | CEO 실측. 가변값(팁 세팅 따라 변동) |
| 플랜지면 → 와이어끝 (TCP540) | 540 mm | 위 합산 |
| TCP 오프셋 (노즐 기준) | X -136.826 / Y +8.192 / Z +506.982 | VERIFIED_LOCK 확정값 |
| 현재 노즐끝↔TCP 정합 | 0.00 mm (완료) | 2026-07-03 검증 통과 |

---

## §2. 결함 목록 (스크린샷 판독 결과)

### D1. 플랜지-손목 간격 — 해결됨 (2026-07-03 밀착 완료). 회귀 감시만.
- 판정 기준: 클로즈업 캡처에서 손목 하단면과 플랜지 상면 사이 공백 픽셀 0.

### D2. 토치 외형 비례가 실물과 다름 — 미해결 (CEO 수용, 별도 건. OPEN_ISSUES 등재)
스크린샷 대조로 판독한 차이 (실물 사진 기준 비율):
| 부위 | 실물 (사진 판독) | 현재 뷰어 | 교정 목표 |
|---|---|---|---|
| 플랜지 원판 지름 | 손목 말단 지름과 거의 같음 (≈1.0배) | 손목보다 확연히 큼 (≈1.3~1.5배) | 손목 말단 지름의 1.0~1.1배로 축소 |
| 플랜지 두께 | 얇은 원판 2단 (합쳐 손목지름의 ~15%) | 두껍고 퍼짐 | 실물 사진 비율로 |
| 플랜지→쇼크센서 간격 | 즉시 밀착 (목 없음) | 목이 길어 처짐 | 간격 최소화 |
- 재모델링 시 반드시 §1 치수(전장 525) 유지. 비례만 수정.
- 방법 후보: 제조사 CAD 확보(최선) / 부위별 스케일 보정(차선 — 장착부만 XY 축소)

### D3. 와이어 15mm 미표시 — 진행 중
- 4안 채택으로 표시 방식 변경 가능성 있음. 티칭 좌표는 와이어끝(노즐+15mm, 공구 Z방향) 기준이어야 함.

### D4. (신규 기능) TCP 드래그 티칭 — 별도 골 프롬프트 참조
- 이 명세서의 판정 기준을 공유: 드래그 결과 자세에서도 D1(밀착)·정합 0.00 유지.

---

## §3. 판정 절차 (모든 토치 시각 작업 공통)

1. 수정 후 headless 캡처를 §0 폴더에 `fix_{항목}_{n}.png`로 저장.
2. **본인이 이미지를 직접 열어** §2 판정 기준과 대조 — 통과 시에만 CEO 보고.
3. CEO가 같은 폴더에 판정 스크린샷을 넣으면 그것을 열어 판독하고 다음 조치.
4. 실물 대조가 필요한 판정은 real_*.jpg와 같은 구도로 캡처를 만들어 나란히 비교.

## §4. 이 사고의 교훈 (CASEBOOK 후보)
"검증 통과" 선언이 두 번 뒤집힌 원인: 숫자(마커 좌표)만 검증하고 화면(토치 메시)을
안 봤음 + CEO 화면 판정이 요약 텍스트로만 전달됨. → 교정: 시각 결과물은 이미지
직접 판독이 검증의 일부다. ceo_feedback 폴더가 그 채널이다.

---
## §0-보강. 실제 포함된 파일 (챗 클로드가 패키징, 2026-07-03)
| 파일 | 내용 |
|---|---|
| real_wrist_closeup_1/2.png | 실물 손목~플랜지~쇼크센서 (밀착·비례 기준) |
| real_torch_full.png | 실물 토치 전체 실루엣 |
| real_torch_ruler_525.jpg | 실물 줄자 실측 — 525mm 근거 사진 |
| viewer_defect_flange_gap_full/closeup.png | 결함 D1 증거 (플랜지 뜸, 수정 전) |
| viewer_defect_tilt_wrong.png | 기울기 반대 증거 (수정 전) |
| ceo_annotated_orange_target.png | CEO가 주황선으로 그린 정답 각도 |
| viewer_flange_attached_closeup.png | D1 밀착 수정 후 상태 |
| viewer_nozzle_at_tcp.png | 노즐-TCP 정합 완료 상태 |
| viewer_torch_full.png | 뷰어 전체 (real_torch_full과 비례 대조용) |
| robodk_tcp_gizmo_reference.png | 4안(TCP 드래그) 참조 — RoboDK 기즈모 |