요구사항
프로그램 맵
프로젝트 쌍별 연결 수와 함께 프로젝트들이 서로 어떻게 연결되는지 보고, 한 항목의 연결 체인을 다른 프로젝트까지 따라갑니다.
이 페이지의 내용
개요
여러 프로젝트(시스템 프로젝트, 서브시스템 프로젝트, 테스트 프로젝트, 라이브러리)에 걸친 프로그램은 다른 프로젝트로의 연결로 묶입니다. 각 연결은 연결을 만든 프로젝트에 저장되므로 어느 한 프로젝트도 전체 그림을 보여 주지 않습니다. 프로그램 맵은 이를 보여 줍니다. 열 수 있는 프로젝트마다 상자 하나, 프로젝트 쌍마다 화살표 하나를 그리고, 화살표에 관계와 연결 수를 레이블로 붙입니다.
이 페이지에는 두 가지 보기가 있습니다.
- 프로젝트: 열 수 있는 모든 프로젝트와 그 사이의 연결을 그래프 또는 표로 보여 줍니다.
- 항목 추적: 가운데에 항목 하나를 두고 다른 프로젝트에서 그 항목에 연결된 항목을 고리별로 최대 여섯 단계 밖까지 보여 줍니다.
프로그램 맵은 로그인한 모든 사용자에게 열려 있습니다. 연결 자체는 Team 요금제에서 만듭니다. 소유자의 요금제에 연결이 포함되지 않는 프로젝트에 저장된 연결은 회색으로 그려집니다. Hybrid Car와 Hybrid Car Battery Pack 데모 프로젝트 사이의 연결은 모든 요금제에서 동작합니다.
개념
맵이 보여 주는 내용
| 요소 | 의미 |
|---|---|
| 상자 | 열 수 있는 프로젝트: 이름, 프로젝트 유형, 항목 수. 접근 가능한 이름에는 보유하고 받는 연결이 추가됩니다 |
| 화살표 | 꼬리 쪽 프로젝트에 저장되어 머리 쪽 프로젝트의 항목을 가리키는 연결 |
| 화살표 레이블 | 관계 · 연결 · 삭제됨. 예: traced from · 12 · 1 deleted |
| 열 수 없는 프로젝트(연결 N개) | 열 수 없는 프로젝트로 가는 모든 연결을 세는 점선 상자 하나 |
| 라이브러리 릴리스 상자 | 프로젝트에서 연결하는, 읽을 수 있는 라이브러리 릴리스 |
화살표는 보통 위를 가리킵니다. 서브시스템 프로젝트는 시스템 프로젝트로의 traced from과 satisfies 연결을 저장하고, 테스트 프로젝트는 verifies 연결을 저장합니다. 맵은 연결을 가진 프로젝트를 그 연결이 가리키는 프로젝트 아래에 배치합니다.
누가 무엇을 보는가
맵은 열 수 있는 프로젝트만으로 만들어집니다. 어떤 역할로든 구성원이고, 휴지통에 있지 않으며, 조직의 2단계 로그인 규칙을 충족하는 프로젝트입니다.
- 열 수 없는 프로젝트로 가는 연결은 열 수 없는 프로젝트(연결 N개)에 집계됩니다. 이 상자는 프로젝트나 항목의 이름을 밝히지 않으며, 프로젝트가 존재하든, 휴지통에 있든, 존재한 적이 없든 똑같이 보입니다.
- 열 수 없는 프로젝트에 저장된 연결은 사용자의 프로젝트를 가리키더라도 어디에도 집계되지 않습니다.
- 조직 관리자라고 해서 더 보이는 것은 없습니다. 맵은 프로젝트 구성원 자격을 사용합니다.
- 내보내기(CSV, SVG, PNG)에는 페이지에 표시되는 내용이 정확히 담깁니다.
색상
| 색상 | 의미 |
|---|---|
| 파란색 화살표 | 열 수 있는 프로젝트 사이의 연결 |
| 주황색 화살표 | 일부 대상이 삭제됨(휴지통에 있거나 없어짐) |
| 회색 화살표 | 열 수 없는 프로젝트나 라이브러리 릴리스로 가는 연결, 또는 소유자의 요금제에 다른 프로젝트로의 연결이 포함되지 않는 프로젝트에 저장된 연결 |
사용 방법
프로젝트 간 연결 보기
- 프로젝트 관리를 클릭한 다음 프로그램 맵을 클릭합니다. 연결을 보유하거나 받는 모든 프로젝트가 있는 프로젝트 보기가 열립니다.
- 화살표를 읽습니다. 상자를 가리키면 그 상자와 연결되지 않은 것이 모두 흐려집니다.
- 화살표를 클릭합니다. 속성 패널에 그 연결이 100개씩 나열됩니다. 각 연결을 가진 항목, 관계, 대상 항목입니다. 항목 중 하나를 클릭하면 해당 프로젝트에서 열리고, 더 보기를 클릭하면 다음 100개가 표시됩니다.
- 그 화살표의 연결을 저장하려면 속성 패널에서 CSV 내보내기를 클릭하고, 맵 전체를 CSV, SVG 또는 PNG로 저장하려면 막대에서 내보내기 ▾를 클릭합니다.
한 프로젝트에서 시작
- 프로젝트를 연 다음 검증 → 프로그램 커버리지를 열고 프로그램 맵 열기를 클릭합니다.
- 맵에는 그 프로젝트와, 직접 또는 다른 프로젝트를 거쳐 연결된 프로젝트만 표시됩니다.
- 열 수 있는 모든 것을 보려면 모든 프로젝트 표시를 클릭합니다.
상자를 클릭하고 연결된 프로젝트만 표시를 선택할 수도 있습니다.
프로그램 전체에서 한 항목 추적
- 항목을 선택합니다. 속성 패널의 추적 섹션에서 다른 프로젝트 ⋯를 열고 프로그램 맵에 표시를 선택합니다. 화살표의 연결 목록에서는 대신 이 항목 추적을 클릭합니다.
- 항목 추적 보기는 가운데에 항목을, 그 주위 고리에 연결된 항목을 보여 줍니다. 첫 번째 고리는 한 단계, 두 번째 고리는 두 단계 밖입니다. 연결은 양방향으로 따라갑니다.
- 더 멀리 가거나 가까이 머물려면 단계(1~6, 기본값 3)를 선택합니다.
- 항목은 프로젝트별로 색이 지정되며, 각 프로젝트의 항목 주위에 점선 상자가 있습니다. 상자를 없애려면 프로젝트별 그룹화를 해제합니다.
- 항목을 클릭하면 항목 열기와 여기서부터 추적(항목을 가운데에 둠)이 나타납니다.
실습 예제: CubeSat EO-1 데모와 탑재체 프로젝트
- CubeSat EO-1 데모를 만든 다음, 요구사항 PL.1 Imager resolution이 있는 두 번째 프로젝트 EO-1 Payload를 만듭니다.
- EO-1 Payload에서 PL.1을 선택합니다. 추적 → 다른 프로젝트에서 +를 클릭하고 traced from, CubeSat 프로젝트, 그 영상 촬영 요구사항을 선택한 다음 링크 추가를 클릭합니다.
- 테스트 케이스 TC.4 Resolution test가 있는 세 번째 프로젝트 EO-1 Test Campaign을 만들고, verifies로 EO-1 Payload의 PL.1에 연결합니다.
- 프로젝트 관리 → 프로그램 맵을 엽니다. 맵에는 맨 아래에 EO-1 Test Campaign, 그 위에 EO-1 Payload, 맨 위에 CubeSat 프로젝트가 표시되며, 화살표 verifies · 1과 traced from · 1이 있습니다.
- PL.1 → 추적 ⋯ → 프로그램 맵에 표시를 클릭합니다. 테스트 케이스와 CubeSat 요구사항이 양쪽에 한 단계 밖에 놓입니다.
실습 예제: Hybrid Car와 그 배터리 팩
- 프로젝트 관리에서 프로젝트 파일 ▾ → 새 데모 프로젝트 → Hybrid Car(SysML v2)를 클릭합니다.
- 이어서 프로젝트 파일 ▾ → 새 데모 프로젝트 → Hybrid Car Battery Pack(SysML v2)을 만듭니다. 배터리 공급업체의 팩 요구사항 PackCapacity, PackMass, ChargeAcceptance가 가장 최근의 Hybrid Car 데모(둘 중 어느 것을 먼저 만들든)에 있는 자동차 요구사항 VR-3, VR-6, VR-5에 traced from으로 연결됩니다. Hybrid Car 데모를 다시 만들면 연결이 새 데모로 옮겨집니다. 이 데모 연결은 모든 요금제에서 동작합니다. Hybrid Car 프로젝트가 없으면 팩 데모에는 연결이 없습니다.
- 프로젝트 관리 → 프로그램 맵을 엽니다. 맵에 두 SysML v2 프로젝트가 화살표 traced from · 3과 함께 표시됩니다.
팁과 모범 사례
- 하위 프로젝트가 사용할 관계(요구사항에는 traced from 또는 satisfies, 테스트에는 verifies)를 합의하면 화살표가 어디서나 같게 읽힙니다.
- 관계마다 화살표 하나씩 보려면 관계 그룹화를 끕니다. 예를 들어 같은 두 프로젝트 사이에서 요구사항 연결과 테스트 연결을 구분할 때 사용합니다.
- 상자를 끌어서 맵을 정리합니다. 위치는 범위마다 이 브라우저에 보관됩니다.
- 프로젝트 쌍을 연결 수나 삭제된 대상 수로 정렬하려면 표 보기를 사용합니다.
- 주황색 화살표는 고쳐야 할 연결을 뜻합니다. 연결 목록을 연 다음 항목의 추적 → 다른 프로젝트에서 연결을 고치거나 제거합니다.
흔한 실수
| 문제 | 원인 | 해결 |
|---|---|---|
| 프로젝트가 보이지 않음 | 해당 프로젝트의 구성원이 아니거나, 휴지통에 있거나, 연결이 없음 | 소유자에게 권한을 요청합니다. 연결이 없는 프로젝트를 나열하려면 연결되지 않은 프로젝트 표시를 선택합니다 |
| 모든 것이 열 수 없는 프로젝트로 감 | 연결이 구성원이 아닌 프로젝트를 가리킴 | 프로젝트 소유자에게 권한을 요청합니다 |
| 맵 가운데의 회색 화살표 | 연결을 가진 프로젝트의 소유자가 Team 요금제를 사용하지 않음 | 소유자가 계정 설정 → 요금제 및 결제에서 업그레이드합니다 |
| 새 연결이 아직 표시되지 않음 | 맵이 아직 최근 변경 사항을 읽는 중 | 1분 후 새로 고침을 클릭합니다 |
다른 기능과의 연결
- 다른 프로젝트로의 연결: 맵은 연결을 읽기만 하며 아무것도 추가하거나 변경하지 않습니다. 연결은 항목의 추적 → 다른 프로젝트에서 만듭니다(다른 프로젝트로의 연결 참조).
- 프로그램 커버리지: 한 프로젝트로 들어오는 연결을 항목별로, 빈틈과 함께 보여 줍니다(프로그램 커버리지 참조). 그곳의 프로그램 맵 열기는 그 프로젝트에서 맵을 시작합니다.
- 라이브러리: 라이브러리 릴리스의 항목으로 가는 연결은 해당 릴리스 상자로 가는 화살표로 나타납니다(라이브러리 참조).
- Spider 다이어그램: 프로젝트 내부의 추적으로, 다른 곳에 있는 연결된 항목은 점선 상자로 표시됩니다. 항목 추적은 같은 고리 배치를 사용합니다.
- API 및 MCP: 도구에 같은 맵과 추적을 제공합니다(API 및 MCP 참조).
프로그램 맵 페이지
막대
| 컨트롤 | 기능 |
|---|---|
| 프로젝트 / 항목 추적 | 보기를 전환합니다 |
| 범위 | 내 모든 프로젝트, 조직 하나(조직에 속한 경우), 또는 하위 폴더를 포함한 폴더 하나(폴더가 있는 경우, 프로젝트 폴더 참조) |
| 모든 프로젝트 표시 | 프로젝트에서 맵을 연 후 표시되며, 그 프로젝트의 연결된 집합을 벗어납니다 |
| 연결되지 않은 프로젝트 표시 | 연결이 없는 프로젝트도 표시합니다 |
| 관계 그룹화 | 프로젝트 쌍마다 화살표 하나(레이블에 각 관계를 나열) 또는 관계마다 화살표 하나 |
| 단계 | 항목 추적: 1~6단계 밖 |
| 프로젝트별 그룹화 | 항목 추적: 각 프로젝트의 항목 주위에 점선 상자 |
| 그래프 / 표 | 다이어그램 또는 정렬 가능한 표. 좁은 화면에서는 표가 먼저 열립니다 |
| 새로 고침 | 연결을 다시 읽습니다 |
| 내보내기 ▾ | CSV 내보내기, SVG 내보내기, PNG 내보내기 |
그래프
- 상자를 클릭하면 속성 패널에 그 프로젝트가 프로젝트 열기, 연결된 프로젝트만 표시와 함께 표시됩니다. 프로젝트를 열려면 상자를 두 번 클릭하거나 상자에서 Shift+Enter를 누릅니다.
- 화살표를 클릭하면 속성 패널에 그 연결이 나열됩니다.
- 상자를 끌어서 옮기고, 스크롤하거나 손가락을 모아 확대/축소하며, 배경을 끌어서 이동합니다.
- Tab을 눌러 맵에 도달한 다음 화살표 키로 상자와 화살표 사이를 이동합니다. Enter는 속성 패널로 이동합니다. 각 상자와 화살표에는 화면 낭독기가 읽는 이름이 있습니다. 예: "EO-1 Payload, LML 프로젝트, 나가는 연결 1개, 들어오는 연결 1개".
표
| 뷰 | 열 |
|---|---|
| 프로젝트 | 원본 프로젝트, 관계, 대상 프로젝트, 연결, 삭제됨 |
| 항목 추적 | 프로젝트, 번호, 이름, 클래스, 항목으로부터의 단계, 상태 |
정렬하려면 열 머리글을 클릭합니다.
속성 패널
| 선택 | 목차 |
|---|---|
| 프로젝트 상자 | 이름, 유형, 항목 수, 나가는 연결과 들어오는 연결. 프로젝트 열기, 연결된 프로젝트만 표시 |
| 화살표 | 원본 및 대상 프로젝트, 관계별 연결, 연결 목록(100개씩, 더 보기), CSV 내보내기, 행마다 이 항목 추적 |
| 항목(항목 추적) | 번호와 이름, 클래스, 프로젝트, 추적한 항목으로부터의 단계, 상태. 항목 열기, 여기서부터 추적 |
| 열 수 없는 프로젝트 | "열 수 없는 프로젝트로의 연결입니다. 프로젝트 소유자에게 접근 권한을 요청하십시오." |
API 및 MCP
REST API와 MCP는 토큰 자체의 권한과 프로젝트 목록으로 같은 답을 제공합니다. API 액세스를 끈 조직의 프로젝트는 열 수 없는 프로젝트처럼 제외됩니다.
| 호출 | 반환값 |
|---|---|
GET /api/v1/program-map | 프로젝트, 릴리스, 화살표(from, to, relation, links, deleted, plan), 숨겨진 개수. from, unlinked, org는 페이지와 같습니다 |
GET /api/v1/projects/<project>/items/<item>/trace | 항목 추적: 프로젝트, 번호, 이름, 클래스, 단계가 있는 노드, 노드 사이의 연결, 숨겨진 개수. steps 1–6(기본값 3) |
MCP program_map | GET /program-map과 같음 |
MCP trace_chain | 추적 호출과 같음. 규제 데이터 표시가 있는 프로젝트의 항목은 withheld로 응답합니다 |
API 및 MCP를 참조하십시오.
메시지
| 메시지 | 의미 |
|---|---|
| 프로젝트 간 연결이 없습니다. 항목의 추적 섹션에서 추가하십시오. | 사용자의 프로젝트 중 볼 수 있는 연결을 보유하거나 받는 프로젝트가 없음 |
| 이 프로젝트에는 다른 프로젝트로의 연결이 없습니다. 항목의 추적 섹션에서 추가하십시오. | 연결이 없는 프로젝트에서 맵을 열었음 |
| 이 항목에는 다른 프로젝트로의 연결이 없습니다. 항목의 추적 섹션에서 추가하십시오. | 추적한 항목에 연결이 없음 |
| 일부 프로젝트를 아직 읽는 중입니다. 잠시 후 새로 고치십시오. | 큰 프로젝트의 최근 변경 사항을 아직 읽는 중이며, 맵은 준비된 것을 표시합니다 |
| 처음 500개 항목을 표시합니다. 단계를 줄이십시오. | 항목 추적이 한도에 도달함 |
| 소유자의 요금제에 다른 프로젝트로의 연결이 포함되지 않는 프로젝트에서 온 연결 N개는 따라가지 않습니다. | 항목 추적이 연결이 포함되지 않는 요금제에 저장된 연결을 건너뜀 |
| 프로그램 맵을 읽지 못했습니다. 페이지를 새로 고치십시오. | 요청이 실패함 |
제한 사항
| 한도 | 값 |
|---|---|
| 항목 추적 단계 | 1~6 |
| 항목 추적의 항목 | 500 |
| 화살표 목록에서 페이지당 나열되는 연결 | 100 |
| 프로젝트당 연결 | 20,000개(다른 프로젝트로의 연결 참조) |