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

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

소프트웨어 목록 페이지(**`/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. 나머지

퍼블리셔 행을 클릭하면 [퍼블리셔 상세 페이지](broken://pages/P0YtxkspYn4kq0G5HCSz)로 이동합니다.

***

### 4. 상태 탭

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

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

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

***

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

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

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

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

***

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

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

| 액션                            | 조건                 |
| ----------------------------- | ------------------ |
| **사용자 추가** (UserPlusIcon)     | 편집 권한 보유           |
| **사용자 제거** (UserMinusIcon)    | 편집 권한 보유           |
| **엑셀 다운로드**                   | 항상 사용 가능           |
| **제외하기** (Trash2Icon, 빨간색)    | 편집 권한 보유, 활성 목록에서만 |
| **복원하기** (ArchiveRestoreIcon) | 편집 권한 보유, 제외 목록에서만 |

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

***

### 7. 컬럼 구성

기본 노출 컬럼:

* **이름** — 로고 썸네일 + 소프트웨어명. 호버 시 `열기` 버튼
* **카테고리** — 편집 권한 보유 시 인라인 편집 가능
* **상태** — 인라인 편집
* **관리자** — 인라인 편집
* **사용자** — 상위 사용자 아바타 스택
* **구독 플랜**
* **발견된 곳** — 카드/은행/GW/에이전트 등 소스 뱃지
* **메모** — 인라인 편집
* **퍼블리셔** (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)
* [퍼블리셔 상세와 임베드 대시보드](broken://pages/P0YtxkspYn4kq0G5HCSz)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/software_management/list-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.