> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/software_management/list-overview.md).

# 소프트웨어 목록 화면 이해하기

## 소프트웨어 목록 화면 이해하기

소프트웨어 목록 페이지(**`/software/list`**)는 SMPLY에 등록된 모든 소프트웨어를 한 곳에서 조회하고 관리하는 메인 화면입니다. 이 문서는 화면 각 요소의 의미와 사용법을 안내합니다.

***

### 1. 헤더 액션 — `소프트웨어 추가하기` SplitButton

페이지 우측 상단에 **`소프트웨어 추가하기`** 분할 버튼(SplitButton)이 있습니다.

**메인 버튼** (PackageIcon) : 클릭하면 **소프트웨어 추가** 폼으로 이동합니다.

**드롭다운 화살표**를 누르면 다음 부가 액션이 펼쳐집니다.

| 아이콘            | 항목               | 동작                           |
| -------------- | ---------------- | ---------------------------- |
| DownloadIcon   | **엑셀 다운로드**      | 현재 필터 기준으로 소프트웨어 목록을 엑셀로 내보냄 |
| —              | —                | —                            |
| CreditCardIcon | **지출 내역 보기**     | `/software/expenditure` 로 이동 |
| FileTextIcon   | **계약 보기**        | `/software/contract` 로 이동    |
| —              | —                | —                            |
| EyeOffIcon     | **제외된 소프트웨어 관리** | `/software/archived` 로 이동    |

{% hint style="info" %}
**편집 권한이 없을 때** `software-edit` 권한이 없는 구성원에게는 SplitButton 대신 `⋯` 아이콘 드롭다운만 표시됩니다. 드롭다운 내용은 동일하므로 부가 기능은 그대로 접근 가능합니다.
{% endhint %}

***

### 2. 상단 메트릭 카드 3장

목록 상단에 조직의 소프트웨어 현황을 요약하는 카드 3장이 표시됩니다.

| 카드           | 표시 내용                            | 동작                                                                   |
| ------------ | -------------------------------- | -------------------------------------------------------------------- |
| **소프트웨어 연동** | `연동됨 수 / 연동 가능 수` + 미연동 퍼블리셔명 뱃지 | 카드 전체 클릭 시 `/settings/integration` 로 이동                              |
| **월간 비용**    | 전월\~현월 누적 KRW                    | 카드 전체 클릭 시 `/software/expenditure` 로 이동, 카드 하단에 *"결제 내역 보기 →"* 링크 표시 |
| **활성 소프트웨어** | `활성 수 / 전체 수` + 미확인/미사용 N개 힌트    | 링크 없음                                                                |

{% hint style="info" %}
**"소프트웨어 연동" 카드는 조건부** 사용 가능한 연동이 하나도 없으면 이 카드는 표시되지 않습니다. JetBrains/Adobe/Autodesk/Anthropic/OpenAI 등 연동 가능한 퍼블리셔가 있을 때 노출됩니다.
{% endhint %}

***

### 3. Tree / Flat 뷰 전환

툴바 좌측의 아이콘 탭으로 두 가지 뷰를 전환합니다.

| 아이콘          | 뷰             | 동작                                  |
| ------------ | ------------- | ----------------------------------- |
| ListTreeIcon | **Tree** (기본) | 퍼블리셔 단위로 소프트웨어를 그룹하여 계층적으로 표시       |
| ListIcon     | **Flat**      | 개별 소프트웨어를 평면 목록으로 표시 + `퍼블리셔` 컬럼 추가 |

**Tree 뷰 그룹핑 규칙**

* 퍼블리셔에 속한 제품이 **2개 이상**이면 퍼블리셔 부모 행이 자동 생성되고 자식 소프트웨어가 아래에 중첩됩니다.
* 제품이 **1개**이지만 연동이 지원되는 퍼블리셔(JetBrains/Adobe/Autodesk/Anthropic/OpenAI 등)인 경우에도 부모 행이 생성됩니다.
* 그 외(`publisherId` 없음 / 연동 미지원 단일 제품)는 단독 행으로 표시됩니다.

**Tree 뷰 정렬**

1. Anthropic / OpenAI 등 AI 퍼블리셔 최상단
2. 연동 지원 퍼블리셔
3. 나머지

퍼블리셔 행을 클릭하면 퍼블리셔 상세 화면(`/software/publisher/{퍼블리셔 ID}`)으로 이동합니다.

***

### 4. 상태 탭

Tree/Flat 토글 오른쪽에 소프트웨어 상태별 탭이 있습니다.

| 탭        | 의미                      |
| -------- | ----------------------- |
| **전체**   | 모든 소프트웨어                |
| **사용 중** | 현재 실사용 중으로 표시된 소프트웨어    |
| **미사용**  | 등록은 됐지만 사용 흔적이 없는 소프트웨어 |
| **미확인**  | 상태가 아직 확인되지 않은 소프트웨어    |

{% hint style="info" %}
**탭 라벨은 상태 라벨과 같습니다** `전체` 탭을 제외한 세 탭의 이름은 소프트웨어 상태 라벨을 그대로 사용합니다. 화면에는 `사용 중` / `미사용` / `미확인` 으로 표시됩니다.
{% endhint %}

제외된 소프트웨어는 여기에 표시되지 않으며, **`소프트웨어 추가하기`** 드롭다운의 **`제외된 소프트웨어 관리`** 로만 조회할 수 있습니다.

***

### 5. 행의 "열기" 버튼 (호버 애니메이션)

각 소프트웨어 행에 마우스를 올리면 우측에 **`열기`** 버튼이 부드럽게 슬라이드되며 나타납니다(150ms). 클릭하면:

* 일반 소프트웨어 행: 해당 소프트웨어의 상세 페이지
* 퍼블리셔 부모 행: 퍼블리셔 상세 페이지

버튼 자리는 평소에 숨겨져 있어 목록이 깔끔하게 보이고, 필요할 때만 포커스를 끌어줍니다.

***

### 6. 벌크 액션 (행 선택 후)

행의 체크박스로 여러 항목을 선택하면 하단에 **Action Bar**가 나타납니다.

| 액션                            | 조건                               |
| ----------------------------- | -------------------------------- |
| **사용자 추가** (UserPlusIcon)     | 편집 권한 보유                         |
| **사용자 제거** (UserMinusIcon)    | 편집 권한 보유                         |
| **엑셀 다운로드**                   | 항상 사용 가능                         |
| **삭제하기** (Trash2Icon, 빨간색)    | 편집 권한 보유, 활성 목록에서만, 직접 등록한 소프트웨어 |
| **제외하기** (EyeOffIcon, 빨간색)    | 편집 권한 보유, 활성 목록에서만, 자동 발견된 소프트웨어 |
| **복원하기** (ArchiveRestoreIcon) | 편집 권한 보유, 제외 목록에서만               |

{% hint style="warning" %}
**삭제와 제외는 다릅니다** **`삭제하기`** 는 직접 등록한 소프트웨어를 실제로 지웁니다(되돌릴 수 없음). **`제외하기`** 는 자동으로 발견된 소프트웨어를 목록에서 숨겨 제외 목록으로 보냅니다(나중에 **`복원하기`** 가능). 선택 항목이 모두 자동 발견 소프트웨어면 **`제외하기`** 하나만, 직접 등록한 소프트웨어가 하나라도 섞이면 **`삭제하기`** 하나만 노출됩니다.
{% endhint %}

Action Bar 우측의 **`일괄 작업 ⌘K`** 버튼으로 커맨드 메뉴를 열어 더 많은 필드 일괄 편집에 접근할 수 있습니다.

***

### 7. 컬럼 구성

기본 노출 컬럼:

* **이름** — 로고 썸네일 + 소프트웨어명. 호버 시 `열기` 버튼
* **카테고리** — 편집 권한 보유 시 인라인 편집 가능
* **상태** — 인라인 편집
* **관리자** — 인라인 편집
* **사용자** — 상위 사용자 아바타 스택
* **구독 플랜**
* **발견된 곳** — 소프트웨어가 어떤 경로로 발견됐는지 보여주는 소스 뱃지. 표시 라벨: `카드` / `계좌` / `구글`(구글 워크스페이스) / `에이전트` / `엑셀` / `결제`
* **메모** — 인라인 편집
* **퍼블리셔** (Flat 뷰 전용)

우측 `보기` 설정에서 컬럼 표시 여부·순서를 조정할 수 있습니다.

***

### 8. 권한 안내

| 작업                    | 필요 권한              |
| --------------------- | ------------------ |
| 목록 조회                 | 로그인된 구성원 (로그인 필요)  |
| 소프트웨어 추가·인라인 편집·벌크 액션 | `software-edit` 권한 |
| 엑셀 다운로드               | 조회 권한만 있어도 가능      |

권한이 없을 때 버튼에 마우스를 올리면 툴팁으로 사유가 안내됩니다.

***

### 9. 관련 가이드

* [소프트웨어 수동으로 추가하기](/software_management/manual_saas.md)
* [소프트웨어 발견](/software_management/discovery.md)
* [소프트웨어 제외하기](/software_management/exclude_saas.md)
* [결제 내역 수동으로 추가하기](/software_management/manual_payment.md)
* [자동화 룰](/software_management/automation-rules.md)