Proven by Intelligence
보이지 않는 안전을 인텔리전스로 증명하다.
기술 인사이트를 만나보세요.
최근 방위산업을 비롯하여 자동차, 항공우주 등 엄격한 규격 준수와 복잡한 요구사항 관리가 필수적인 산업군을 중심으로 PTC Codebeamer 최신 버전을 도입하는 기업이 빠르게 늘고 있습니다.
대규모 프로젝트의 복잡성을 제어하고 트래커 기반으로 수명 주기를 통합 관리할 수 있는 강력한 도구이기 때문이죠.
하지만 대학교나 일반 프로젝트에서 엑셀(Excel) 위주로 문서를 관리해 왔던 신입 엔지니어들에게 Codebeamer의 객체 지향적 데이터 구조와 트래커(Tracker) 개념은 다소 낯설게 느껴질 수 있습니다.
의욕적으로 시스템을 만지다가 의도치 않게 설정을 꼬아버려 선배 엔지니어들의 가슴을 철렁하게 만드는 일도 종종 발생하곤 합니다.
오늘은 현업 실무에서 가장 자주 발생하는 '신입 엔지니어가 Codebeamer환경에서 저지르기 쉬운 대표적인 실수 3가지'와 이를 예방하기 위한 확실한 가이드를 공유합니다.
실수1: 규칙을 무시한 "무분별한 커스텀 필드(Custom Field) 설정"
Codebeamer의 가장 큰 장점 중 하나는 사용자의 입맛에 맞게 트래커의 속성을 자유롭게 확장할 수 있는 유연성입니다. 하지만 프로젝트의 표준 스키마와 필드 레이아웃 규칙을 숙지하지 못한 신입 사원들은 새로운 요구사항이나 테스트 속성이 필요할 때마다 임의로 커스텀 필드를 양산하는 실수를 범하곤 합니다.
"상위 요구사항의 진척도 연산 결과를 임시로 확인해야 해서, 트래커 설정에 들어가 비어 있는 필드 아무 데나 수식을 넣고 필드명을 바꿨어요!"
실제 현업 에피소드
왜 치명적인 문제가 될까요?
계산 엔진과 트래커 뷰는 프로젝트 초기에 정의된 데이터 구조를 기반으로 고도화되어 작동합니다. 시스템적인 필드 격리 규칙과 할당 원칙을 무시하고 필드를 무작위로 다루면 다음과 같은 문제가 생깁니다.
그림1. Codebeamer Fields의 숨은 명칭(Property)
✅ 연산 로직의 충돌:
트래커 내부에서 상태 모니터링이나 자동 진척률 계산을 위해 아키텍처상 지정된 전용 커스텀 속성(예: customField[n] 또는 choiceList[n])이 있습니다. 정해진 속성 번호의 용도를 무시하고 임의의 필드에 수식을 걸거나 데이터를 채워 넣으면, 기존에 정상적으로 작동하던 프로젝트 대시보드와 상위 연산 로직이 통째로 꼬여버릴 수 있습니다.
※ customField[n] 또는 choiceList[n]의 숫자 [n]은 프로젝트와 트래커마다 바뀔 수 있기 때문입니다.
그림2. Codebeamer Field의 계산식 예시
✅ 데이터 정형성 훼손:
한 번 잘못 꼬인 필드 레이아웃은 나중에 트래커 간 마이그레이션이나 템플릿 배포 시 에러를 유발하는 주원인이 됩니다.
실수 2: 연동 맥락(Context)이 빠진 "묻지마 추적성(Traceability) 링크 생성"
고신뢰성 제품 개발에서 가장 중요한 핵심은 '완벽한 추적성(Full Traceability)'의 확보입니다. 시스템 요구사항부터 소프트웨어 설계, 그리고 실제 구현된 소스코드와 검증 테스트 케이스까지 단 한 줄의 끊김도 없이 연결되어야 하죠.
신입 사원들은 "추적성 링크를 누락 없이 연결하라"는 지시를 받으면, '왜(Why)' 이 항목들이 연결되어야 하는지 깊이 고민하지 않고 단순히 링크 맵을 채우기 위해 무작위로 항목들을 드래그 앤 드롭하여 연결하곤 합니다.
그림3. 이런 일이 생기기도 합니다
왜 치명적인 문제가 될까요?
✅ 가짜 추적성(False Traceability)의 늪:
항목 간에 실질적인 기술적 연관성이 없음에도 링크만 연결되어 있다면, 추적성 브라우저(Traceability Browser)상으로는 정상처럼 보이지만 정작 시스템 감사(Audit)나 인증 단계에서 맥락을 설명하지 못해 지적을 받게 됩니다.
✅ 변경 영향 분석(Impact Analysis)의 마비:
요구사항 하나가 미세하게 수정되었을 때, 무맥락으로 얽히고설킨 수많은 하위 트래커 항목 전체에 '변경 의심(Suspect)' 플래그가 켜지게 됩니다. 이로 인해 불필요한 재검토 작업이 폭증하여 프로젝트 일정이 지연되는 결과를 초래합니다.
그림4. 엄청난 양의 변경 의심 플래그
근본적인 해결책:
좋은 프로세스는 다소 불편한 법 (엄격한 Tracker Administration 통제)
앞서 언급한 실수들은 단순히 신입 엔지니어 개인의 주의 부족 탓으로만 돌릴 수 없습니다. 엔지니어 개개인의 선의나 조심성에만 의존하는 프로세스는 반드시 실패하기 때문입니다.
특히 방위산업처럼 단 하나의 데이터 오류도 용납되지 않는 고신뢰성 환경에서는 시스템적인 거버넌스(Governance)와 강력한 권한 통제가 유일한 해결책입니다.
01.
Tracker Administration 권한의 엄격한 제한
가장 먼저 해야 할 일은 일반 엔지니어(특히 신입 사원)가 Tracker Configuration(트래커 설정) 메뉴에 접근할 수 없도록 권한을 차단하는 것입니다.
이는 프로젝트 관리자가 Admin - Members – Edit Role Permissions 에서 수정할 수 있습니다.
Tracker – Administrate 를 제한하면, Tracker Configuration 화면에 접근이 불가능합니다.
그림5. Tracker Administrate 제한
커스텀 속성을 추가하거나 추적성 필드를 수정하는 작업은 반드시 지정된 관리자(System/Project Admin) 또는 형상관리 담당자(CM)만 수행할 수 있도록 막아야 합니다.
이는 Tracker Administrate 권한이 있는 사용자가, Tracker Configuration – Permission 메뉴에서 설정할 수 있습니다.
그림6. 트래커 단위의 권한 지정
필드 하나를 추가하더라도 공식적인 변경 요청 프로세스를 거치도록 체계를 강제해야 시스템의 정형성이 유지됩니다.
02.
표준 커스텀 필드 및 추적성 필드의 격리와 보호
수식 연산이나 진척도 대시보드에 직접적인 영향을 주는 핵심 속성들은 별도의 보안 정책을 통해 수정 불가능하도록 락(Lock)을 걸어야 합니다. 예를 들어, 연산 최적화를 위해 설계된 customField[2] 나 choiceField[3] 같은 필드들은 일반 사용자의 화면 레이아웃에서 숨기거나 읽기 전용으로 격리하여, 휴먼 에러로 인해 수식 백엔드가 오염되는 것을 원천 차단해야 합니다.
커스텀 필드도 개별 권한 설정이 가능합니다.
그림7. 필드 단위의 권한 지정
03.
편의성보다 중요한 것은 '거버넌스 준수'
"화면 수정 권한을 막아두면 일일이 요청해야 해서 업무가 너무 불편하고 느려집니다"라는 현업의 불만이 나올 수 있습니다.
04.
그러나 좋은 프로세스는 원래 다소 불편한 법입니다.
엔지니어 한 명의 '순간적인 편의'를 위해 시스템 문을 열어두었다가, 훗날 고객사의 Audit 단계에서 추적성이 통째로 깨지거나 연산 오류로 인해 데이터 신뢰성이 훼손되었을 때 치러야 할 대가는 비교할 수 없을 정도로 참혹합니다. 조금 삐걱거리고 절차가 늘어나더라도, 정해진 템플릿과 규칙을 모두가 예외 없이 지키도록 강제하는 성숙한 거버넌스가 Codebeamer 도입의 진정한 가치입니다.
Codebeamer는 단순한 도구가 아니라 '프로세스'입니다
신입 엔지니어들이 유독 Codebeamer를 다룰 때 실수를 많이 하는 이유는 도구의 사용법 자체가 어려워서라기보다, 내가 입력한 데이터가 전체 개발 수명 주기와 동료들의 공정에 어떤 나비효과를 불러일으킬지 아직 프로세스의 큰 그림을 채 파악하지 못했기 때문입니다.
처음에는 조금 시간이 걸리더라도 정해진 규칙을 철저히 준수하고, 링크 하나를 걸더라도 명확한 맥락을 남기는 습관을 들인다면, 프로젝트의 핵심 자산을 안전하게 지켜내는 '일 잘하는 A급 시스템 엔지니어'로 빠르게 성장할 수 있을 것입니다.
글을 마치며: 시스템 일관성이 가져오는 진정한 가치
MDS인텔리전스는 프로세스 표준화 및 완벽한 형상 관리를 지원하는 ALM 전문 기술 파트너입니다.
최신 Codebeamer의 특성을 고려하여, 현업의 휴먼 에러를 원천 차단하는 엄격한 트래커 권한(Administration) 설계, 핵심 커스텀 필드 및 계산 필드의 안정적인 격리 구성, 그리고 GitLab과 같은 소스코드 저장소 및 각종 테스트 도구 연동 시 추적성 맥락을 강제하는 최적의 Configuration 아웃라인을 제공합니다.
시스템의 일관성을 유지하고 방산 Audit을 완벽하게 통과할 수 있는 단단한 거버넌스를 구축하고 싶으시다면, 언제든 당사의 기술 전문가 팀에 문의해 주시기 바랍니다!
출처 : https://support.ptc.com/
📧 codebeamer@mdsshpere.co.kr ✍️문의남기기
