시작하기
프로젝트 폴더
프로젝트 페이지에서 프로젝트를 폴더와 하위 폴더로 묶습니다. 내 폴더나 조직의 공유 폴더 트리에 넣을 수 있으며, 끌기, 메뉴 또는 키보드로 이동합니다.
이 페이지의 내용
개요
폴더는 프로그램의 프로젝트를 한데 모읍니다. 시스템 프로젝트, 서브시스템 프로젝트, 테스트 프로젝트, 공급업체 모델이 이에 해당합니다. 폴더 안에 폴더를 최대 8단계까지 넣을 수 있습니다. 프로젝트 페이지(프로젝트 관리)는 폴더를 프로젝트 목록 옆에 트리로 보여 줍니다.
폴더 트리에는 두 종류가 있습니다.
- 내 폴더: 나만의 폴더입니다. 나만 볼 수 있습니다. 내가 속한 조직에 있지 않은 내 프로젝트와 다른 사람이 나와 공유한 프로젝트가 들어갑니다.
- 조직의 폴더: 내가 속한 조직마다 하나씩 있는 트리로, 모든 구성원에게 같습니다. 관리자가 트리를 정리하며, 관리자와 프로젝트 소유자가 프로젝트를 트리에 넣습니다.
폴더는 모든 요금제에서 사용할 수 있습니다. 조직 폴더 트리는 조직이 있는 곳이면 어디에나 있습니다.
개념
프로젝트가 속한 트리
각 프로젝트는 나에게 정확히 하나의 트리에, 그리고 그 트리의 최대 하나의 폴더에 있습니다.
| 프로젝트 | 나에게 보이는 트리 |
|---|---|
| 내가 구성원인 조직에 속함 | 그 조직의 트리 |
| 열 수 있는 그 밖의 모든 프로젝트 | 내 폴더 |
트리의 최상위에 있어 어떤 폴더에도 속하지 않은 프로젝트는 트리 자체를 선택하면 나열됩니다.
누가 무엇을 할 수 있는지
| Action | 내 폴더 | 조직의 폴더 |
|---|---|---|
| 폴더 보기 | 나 | 모든 구성원 |
| 폴더 만들기, 이름 바꾸기, 이동, 삭제 | 나 | 조직 관리자 |
| 프로젝트를 폴더에 넣거나 폴더에서 꺼내기 | 나(열 수 있는 모든 프로젝트) | 조직 관리자와 프로젝트 소유자 |
| 조직의 감사 로그에 기록 | 아니요 | 예: 만들기, 이름 바꾸기, 이동, 삭제된 모든 폴더와 폴더 사이에서 이동된 모든 프로젝트 |
조직 외부의 사람이 그 조직의 프로젝트를 공유받더라도 조직의 폴더 이름은 볼 수 없습니다. 그 사람에게 프로젝트는 자신의 내 폴더에 있으며, 직접 폴더에 넣을 때까지 최상위에 있습니다.
프로젝트는 조직이 바뀔 때(공유…)만 다른 트리로 이동합니다. 이동하면 새 트리의 최상위에서 시작합니다.
사용 방법
사용 시기와 이유
프로젝트를 서로 연결할 때 폴더를 만듭니다. 프로그램 하나가 폴더 하나가 되고, 서브시스템이나 공급업체마다 하위 폴더가 생깁니다. 그러면 폴더는 그 안의 프로젝트들이 서로 어떻게 연결되는지 보여 주는 프로그램 맵의 범위도 됩니다.
폴더 만들기
- 프로젝트 관리를 엽니다.
- 새 폴더가 들어갈 트리나 폴더를 선택합니다.
- 목록 위의 새 폴더를 클릭합니다.
- 이름을 입력하고 Enter를 누릅니다.
트리에 새 폴더가 옆에 0과 함께 표시됩니다. 폴더의 ⋯ 메뉴에도 새 하위 폴더…가 있으며, ⌘K / Ctrl+K → 새 프로젝트 폴더…는 내 폴더의 최상위에 폴더를 만듭니다.
프로젝트를 폴더로 이동하기
- 프로젝트가 들어 있는 폴더나 모든 프로젝트를 선택합니다.
- 프로젝트 행을 트리의 폴더나 목록의 폴더 행으로 끌어 놓습니다.
실행 취소와 함께 “Mars Rover을(를) Avionics(으)로 이동했습니다.”가 표시됩니다.
여러 프로젝트를 한 번에 이동하려면:
- 각 행 앞의 상자를 선택합니다. Shift+클릭은 마지막으로 선택한 행과 이 행 사이의 모든 행을 선택하며, 머리글의 상자는 목록 전체를 선택합니다.
- 선택한 행 중 하나를 폴더로 끌어 놓거나 목록 위 막대의 폴더로 이동…을 클릭합니다.
- 폴더로 이동에서 폴더를 선택하고 이동을 클릭합니다.
끌지 않으려면 프로젝트의 ⋯ 메뉴에서 폴더로 이동…을 사용하거나, 프로젝트가 열려 있는 동안 ⌘K / Ctrl+K → 프로젝트를 폴더로 이동…을 사용합니다. 그 대화 상자의 새 폴더…는 선택한 폴더 안에 폴더를 만듭니다.
폴더 정리하기
- 이름 바꾸기: 트리에서 폴더를 선택하고 F2를 누르거나 ⋯ → 이름 바꾸기…를 사용합니다.
- 이동: 폴더를 같은 트리의 다른 폴더로 끌어 놓거나 ⋯ → 폴더 이동…을 사용합니다. 폴더는 자기 자신이나 자신의 하위 폴더 안으로는 이동하지 않습니다.
- 삭제: ⋯ → 폴더 삭제…를 사용하거나 트리에서 Delete를 누릅니다. 그 안의 프로젝트와 하위 폴더는 상위 폴더로 올라가며, 프로젝트는 삭제되지 않습니다. 위로 올라간 하위 폴더의 이름이 그곳에서 이미 사용 중이면 Power (2)처럼 번호가 붙습니다.
모든 변경에는 실행 취소가 있는 메시지가 표시됩니다.
모든 폴더에서 프로젝트 찾기
프로젝트 찾기에 입력합니다. 선택된 항목과 관계없이 모든 폴더에서 검색하며, 이름, 설명, 프로젝트 ID, 폴더 경로와 일치하는 것을 찾습니다. 폴더 열에 각 결과의 위치가 표시됩니다.
실습 예제: CubeSat 프로그램
- CubeSat EO-1 데모를 만듭니다(프로젝트 파일 ▾ → 새 데모 프로젝트).
- 내 폴더를 클릭한 다음 새 폴더를 클릭하고 이름을 EO-1 Program으로 지정합니다.
- EO-1 Program을 선택한 상태에서 새 폴더를 두 번 클릭하여 Spacecraft와 Ground Segment를 만듭니다.
- 모든 프로젝트를 선택하고 CubeSat EO-1을 Spacecraft로 끌어 놓습니다.
- EO-1 Program ⋯ → 프로그램 맵에서 열기를 엽니다. 맵에 프로그램 폴더와 그 하위 폴더에 있는 모든 프로젝트가 표시됩니다.
팁과 모범 사례
- 폴더 이름은 사람이 아니라 프로그램, 시스템, 공급업체를 따라 짓습니다. 폴더 트리는 팀보다 오래 남습니다.
- 조직의 공유 폴더는 조직의 프로그램용으로 둡니다. 개인적인 실험은 내 폴더에 넣습니다.
- 검토 전에 프로그램 폴더에서 프로그램 맵에서 열기를 사용하여 어떤 연결이 빠졌는지 확인합니다.
흔한 실수
- “Avionics은(는) Acme의 폴더입니다. 먼저 공유…로 …을(를) Acme(으)로 옮기십시오.” 다른 트리의 프로젝트를 조직 폴더에 놓았습니다. 공유…에서 프로젝트의 조직을 변경하거나 내 폴더에 넣습니다.
- “프로젝트 소유자와 …의 관리자만 …을(를) 넣을 수 있습니다.” 조직의 트리에서는 소유자가 아닌 구성원은 프로젝트를 이동할 수 없습니다. 소유자나 관리자에게 요청합니다.
- 검색 후 폴더가 비어 보입니다. 목록에 모든 폴더의 검색 결과가 표시되고 있습니다. 프로젝트 찾기를 지웁니다.
연결 방식
- 프로그램 맵: 폴더는 범위입니다(범위 메뉴 또는 폴더의 ⋯ → 프로그램 맵에서 열기).
- 다른 프로젝트로의 연결: 폴더는 서로 연결되는 프로젝트를 묶습니다.
- API 및 MCP: list_projects와
GET /api/v1/projects가 각 프로젝트의folder경로를 제공합니다. - 가져오기 및 내보내기: 프로젝트 내보내기는 폴더 경로를 기록하며, 가져오기는 이를 내 폴더에 다시 만듭니다.
프로젝트 페이지
폴더 트리
| 요소 | 기능 |
|---|---|
| 모든 프로젝트 | 열 수 있는 모든 프로젝트를 한 목록에 표시 |
| 조직의 이름 | 그 조직의 공유 트리: 최상위의 프로젝트와 폴더 |
| 내 폴더 | 나만의 트리 |
| 폴더 | 하위 폴더와 바로 그 안에 있는 프로젝트를 나열 |
| 노드 옆의 숫자 | 폴더와 하위 폴더에 있는 프로젝트 수 |
| ▸ / ▾ | 하위 폴더를 표시하거나 숨김(이 브라우저에 기억됨) |
폴더를 마우스 오른쪽 버튼으로 클릭하거나 Shift+F10을 누르면 메뉴가 열립니다. 새 하위 폴더…, 이름 바꾸기…, 폴더 이동…, 프로그램 맵에서 열기, 폴더 삭제…가 있습니다. 조직의 트리에서 관리자가 아닌 구성원에게는 프로그램 맵에서 열기만 표시됩니다.
목록 위
- 이동 경로: 선택한 폴더의 경로입니다(예: 내 폴더 › EO-1 Program › Spacecraft). 한 부분을 클릭하면 위로 이동합니다.
- 선택 막대: 행이 선택되어 있는 동안 표시됩니다. 프로젝트 n개 선택됨, 폴더로 이동…, 선택 해제.
목록 안
- 폴더 행이 먼저 나옵니다. 폴더 이름과 프로젝트 수, 메뉴를 여는 ⋯가 있습니다. 이름을 클릭하면 폴더가 열립니다.
- 프로젝트 행은 선택 상자로 시작합니다. 링크, 버튼, 상자가 아닌 아무 부분이나 잡고 행을 끕니다.
- 빈 폴더에는 새 하위 폴더와 함께(내 폴더에서는 + 새 프로젝트도 함께) “이 폴더는 비어 있습니다.”가 표시됩니다. 새 프로젝트는 내 폴더에서 선택된 폴더에 들어갑니다. 다른 폴더를 원하면 새 프로젝트 대화 상자의 폴더에서 선택합니다.
프로젝트 환경설정
프로젝트 환경설정…의 폴더는 프로젝트가 속한 트리의 폴더를 나열합니다. 프로젝트를 넣을 수 없는 경우에는 흐리게 표시됩니다.
키보드와 화면 낭독기
폴더 트리는 탭 정지점 하나입니다.
| 키 | Action |
|---|---|
| ↑ / ↓ | 이전 또는 다음 폴더 |
| → | 폴더의 하위 폴더를 표시하거나 첫 번째 하위 폴더로 이동 |
| ← | 하위 폴더를 숨기거나 상위 폴더로 이동 |
| Home / End | 첫 번째 또는 마지막 폴더 |
| Enter 또는 Space | 목록에 폴더 표시 |
| F2 | 폴더 이름 바꾸기 |
| Delete | 폴더 삭제(먼저 확인) |
| Shift+F10 | 폴더의 메뉴 |
| 문자 | 그 문자로 이름이 시작하는 다음 폴더 |
화면 낭독기는 각 폴더의 이름과 프로젝트 수, 펼침 여부, 그리고 모든 이동, 이름 바꾸기, 삭제, 실행 취소를 일어나는 즉시 읽어 줍니다.
제한 사항
| 한도 | 값 |
|---|---|
| 폴더 이름 | 1~80자 |
| 폴더 깊이 | 8단계 |
| 트리당 폴더 수 | 1,000 |
| 같은 이름 | 한 폴더 안에서 중복 불가(대소문자는 구분하지 않음) |
메시지
| 메시지 | 의미 |
|---|---|
| “…”이라는 이름의 폴더가 이미 있습니다. 다른 이름을 선택하십시오. | 이름을 지정하거나 이동해 들어가는 폴더에 그 이름의 폴더가 이미 있음 |
| 폴더는 최대 8단계까지만 중첩됩니다. 더 위에 있는 폴더를 선택하십시오. | 새 폴더나 이동한 폴더가 8단계보다 깊어짐 |
| 폴더는 자기 자신이나 자신의 하위 폴더 안으로 이동할 수 없습니다. | 이동하는 폴더 밖의 폴더를 선택 |
| 이 조직의 관리자만 조직의 폴더를 변경할 수 있습니다. | 조직 관리자에게 요청 |
| 선택한 프로젝트가 서로 다른 폴더 트리(…)에 있습니다. 한 트리의 프로젝트를 선택하십시오. | 트리별로 따로 프로젝트를 이동 |
관련 항목
- 도움말: 폴더로 프로젝트 정리하기, 프로젝트 관리
- Docs: 프로그램 맵, 다른 프로젝트로의 연결, 공동 작업