CAD 엔지니어링 워크플로우

CAD 엔지니어링 워크플로우은(는) 무엇을 하나요?

저장소 지침과 저장소 소유의 검증기를 권위 있는 출처로 취급하십시오. 이 스킬을 사용하여 작업을 체계적으로 수행하되, 프로젝트별 요구사항을 일반적인 가정으로 대체하지 마십시오.

1. 계약 수립

1. 코드를 작성하기 전에 모든 해당 AGENTS.md, 전체 프로젝트 가이드, 활성 도면 스냅샷, 요청된 Issue를 읽으십시오.
2. 변경 불가능한 기준 태그, CAD 경로, SHA-256, 좌표계, 단위계, 현재 구성품 재고, 예상 출력 본체, 릴리스 대상을 식별하십시오.
3. 진실 출처가 충돌하거나 기준을 확인할 수 없는 경우 편집을 시작하기 전에 중단하십시오.
4. 요청된 결과를 관련 Issue 컨텍스트와 분리하십시오. 백로그를 작업에 흡수하지 마십시오.
5. Issue, 저장소 정책 또는 사용자가 선언한 릴리스 트랙(디지털 CAD/도면 또는 물리적으로 검증된 제품)을 선택하십시오. 도면 릴리스는 제품 검증을 의미하지 않습니다.
6. 모든 승인 기준을 권위 있는 계약에 따라 계산적, 시각적, 물리적, 또는 작업자 전용으로 분류하십시오. 도면 트랙의 경우, fit, install, remove, clip, actuate, route, access와 같은 표현은 계약에서 명시적으로 제조 샘플이나 직접 테스트를 요구하지 않는 한 디지털 형상/경로 검증을 의미합니다. 일반적인 엔지니어링 리스크를 필수 게이트로 승격시키지 말고, 물리적 기준을 형상만으로 통과했다고 보고하지 마십시오.

기준을 선택하거나 검증할 때 기준 및 진실 출처를 읽으십시오. 기존 실패한 후보를 수리하기 전에 실패 패턴을 읽으십시오.

2. 수정 전 검사

1. 기존 네이티브 CAD 문서를 열고 트리, 객체 유형, 표현식, 속성, 배치, 그룹, 솔리드, 가시성, 재계산 상태를 검사하십시오.

2. 기계 판독 가능한 기준 보고서를 기록하십시오. FreeCAD를 사용할 수 있는 경우 다음을 실행하십시오:

   python scripts/run_inspect_fcstd.py --freecad FreeCADCmd.exe --file <baseline.FCStd> --output <baseline-report.json>

3. 메시, STEP, 스크린샷, 스냅샷 또는 부트스트랩 생성기에서 기존 네이티브 문서를 재구축하지 마십시오.

4. 작업에서 해당 변경 사항을 명시적으로 요구하지 않는 한 사용자가 저장한 배치, 색상, 가시성, 표현식 또는 수동 편집을 덮어쓰지 마십시오.

5. 저장소 규칙이 이전 릴리스를 변경 불가능하게 만드는 경우 새 버전 경로에서 작업하십시오.

3. 가장 작은 완전한 엔지니어링 변경 구현

1. 정확하고 고정된 구성품 소스를 사용하십시오. 편집 가능한 소스, 정확한 가져온 아티팩트, 이력 개정, SHA-256을 함께 보존하십시오.
2. 외부 구성품을 저장소의 임베디드 소스 그룹에 배치하고 검증된 모델에서 장착 형상을 파생시키십시오.
3. 레거시 형상을 네이티브 업스트림 피처에서 교체하십시오. 다운스트림 완성 본체에 패치, 플레이트, 플러그, 스킨, 필러 또는 동일 평면 수리를 융합하여 구멍, 포켓, 릴리프 또는 장착 피처를 은폐하지 마십시오.
4. 네이티브 사전 피처 본체 또는 편집 가능한 구조 체인을 복구할 수 없는 경우 블로커와 함께 중단하십시오. 요청된 최종 형상을 얻기 위해 추가 수리 형상을 대체하지 마십시오.
5. 저장소가 Sketcher 기반 제어를 요구하는 경우 제어 형상을 편집 가능하고 완전히 구속된 상태로 유지하십시오.
6. 모든 제어 피처를 검사 가능한 종속성 또는 순차적 부울 체인을 통해 최종 출력 본체에 연결하십시오. 스케치 또는 커터의 존재가 통합을 증명하지 않습니다.
7. 구성품을 교체할 때 더 이상 사용되지 않는 구성품별 컷, 릴리프, 레이블, 활성 임베디드 소스 및 다운스트림 잔재를 제거하십시오.
8. 관련 없는 구성품 배치, 출력 본체, 좌표계, 외관 및 문서 구조를 보존하여 부수적 변경을 제한하십시오.

모든 교체 또는 크기 조정된 개구에 대해 네이티브 피처 교체를 읽고 따르십시오. 구성품 작업은 구성품 통합을, 네이티브 모델링 및 부울 연산은 파라메트릭 형상을 읽으십시오.

4. 계층별 검증

각 의미 있는 형상 그룹 후에 검증을 실행하십시오. 마지막에만 실행하지 마십시오.

1. 재계산하고 문서 오류를 거부하십시오.
2. 저장, 닫기, 다시 열기, 재계산, 저장, 다시 열기를 수행하십시오.
3. 예상 출력 본체 수, 솔리드 수, 경계, 부피, 토폴로지를 확인하십시오.
4. 요청된 피처가 의도된 최종 본체에 영향을 미치는지 증명하십시오.
5. 교체의 경우, 영향을 받는 로컬 솔리드가 새로운 의도된 연산만 적용된 네이티브 수정되지 않은 피처와 동일함을 증명하십시오. 잔여 레거시 윤곽, 추가 수리 종속성, 추가 동일 평면 경계, 숨겨진 필러 본체를 거부하십시오.
6. 충돌과 필수 접촉을 별도로 확인하십시오. 필수 장착 접촉은 원치 않는 충돌이 아닙니다.
7. 조립 순서, 제거 경로, 커넥터 삽입 경로, 패스너 축, 도구 엔벨로프, 터미널 접근, 배선 공간, 굽힘 반경, 변형 완화를 해당되는 경우 디지털로 확인하십시오. 이 증거를 기하학적이라고 표시하십시오. 물리적 적합성, 힘 또는 내구성을 주장하지 마십시오.
8. 일회용 복사본에서 파라메트릭 편집 가능성을 테스트한 후 원래 매개변수를 복원하십시오.
9. 필요한 STL 및 STEP 아티팩트를 내보내고 각 내보내기를 독립적으로 다시 여십시오.
10. 구성품이 표시되고 숨겨진 상태로 클로즈업을 렌더링하여 네이티브 개구와 주변 벽을 검토할 수 있도록 하십시오.
11. 저장된 FCStd를 렌더링하십시오. 근사 평행 모델을 렌더링하지 마십시오.
12. 러너가 제어하는 대로 모든 저장소 소유 테스트를 정확히 실행하십시오.

run_inspect_fcstd.py로 후보 보고서를 생성한 후 다음을 사용하여 기준과 비교하십시오:

python scripts/compare_fcstd_reports.py --baseline <baseline-report.json> --candidate <candidate-report.json>

각 게이트에 필요한 증거는 검증 매트릭스를 읽으십시오.

5. 일관된 릴리스 후보 조립

1. 네이티브 CAD, 임베디드 소스, 내보내기, 미리보기, 레이아웃, 매니페스트, 스냅샷, 버전 노트, 활성 인덱스가 상호 일관되도록 유지하십시오.
2. 최종 아티팩트 생성 후에만 SHA-256을 재계산하십시오. 해시를 포함하는 파일 변경 후 검증을 다시 실행하십시오.
3. 차이 또는 저장된 해시로 이전 기준 불변성을 증명하십시오.
4. 프로젝트 정책이 자동 생성을 금지하는 경우 수동 전용 형식을 비워 두십시오.
5. 필수 게이트가 완료되지 않은 경우 태그 또는 릴리스를 생성하거나 승인하지 마십시오.
6. 필수 디지털 게이트가 통과하면 선택적 미래 물리적 검증이 실행되지 않았더라도 도면 릴리스를 허용하십시오. 생산 준비 완료 또는 물리적으로 검증됨으로 표시하지 마십시오.
7. 필요한 물리적 구축, 측정, 조립, 엔지니어 서명이 통과된 후에만 정확한 도면 커밋에서 제품 검증 릴리스를 생성하십시오.

릴리스 트랙 및 태그 정책을 선택하려면 릴리스 수명 주기를 읽으십시오. 완료를 선언하기 전에 릴리스 게이트를 읽으십시오.

6. 정직하게 보고

• 선택된 릴리스 트랙에 대한 모든 작업 필수 게이트가 통과하면 completed를 반환하십시오.
• 권위 있는 작업 또는 저장소 소스가 불완전한 물리적 또는 작업자 게이트를 명시적으로 요구하는 경우에만 완료된 후보를 보존한 상태로 blocked를 반환하십시오.
• 요청된 상태가 이미 존재함을 증명한 후에만 no_change_needed를 반환하십시오.
• 요청되지 않은 쿠폰, 사이클, 진동, 핀아웃, 배선 또는 기타 물리적 테스트는 블로커가 아닌 후속 권장 사항으로 기록하십시오. 승인 기준을 발명하지 마십시오.
• 각 블로커를 증거와 하나의 실행 가능한 다음 단계와 함께 별도로 나열하십시오.
• not_run, failed, passed를 구분하십시오. 증거 부족을 성공으로 전환하지 마십시오.
• 릴리스 블로커를 위험이나 요약 텍스트에 숨기지 마십시오.