> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/spaces/about-spaces.md).

# 스페이스 개요

스페이스는 테스트 케이스·기능 목록·시나리오 등의 구조화된 QA 데이터를 유형이 지정된 테이블로 관리하는 워크스페이스 탭입니다.

{% hint style="info" %}
이 기능은 일부 고객부터 순차적으로 공개되고 있습니다.
{% endhint %}

## 개요

QA 팀이 테스트 설계 작업을 협업할 때, 테스트 케이스 목록·상태·리뷰 현황 등을 기록하고 추적하기 위한 공유된 구조화 공간이 필요합니다. 스페이스는 Genesis 내에서 그 역할을 담당하며, AI 어시스턴트 및 워크플로와 함께 구조화된 데이터를 AI 기반 작업과 가까운 곳에서 관리할 수 있게 합니다.

스페이스는 하나 이상의 **컬렉션**(유형이 지정된 테이블)을 담는 컨테이너입니다. 각 행은 하나의 레코드(예: 테스트 케이스)를 나타내며, 행이 가지는 컬럼을 정의하고 하위 컬렉션을 사용하여 행 아래에 추가 데이터를 중첩할 수 있습니다.

## 주요 개념

### 스페이스

스페이스는 스페이스 탭 내의 최상위 컨테이너입니다. 워크스페이스 안에 여러 스페이스를 만들 수 있으며, 제품 영역·테스트 단계·용도 등으로 구분하여 관리할 수 있습니다.

### 컬렉션

컬렉션은 스페이스 안의 유형이 지정된 테이블입니다. 각 스페이스에는 최소 하나의 컬렉션이 있습니다. 같은 스페이스에 컬렉션을 추가하여 서로 다른 종류의 데이터를 저장할 수 있습니다(예: "결제 흐름" 스페이스에 테스트 케이스용과 알려진 버그용 컬렉션을 각각 만들기).

### 행

행은 컬렉션 안의 하나의 레코드입니다. 각 행은 컬렉션의 **스키마**에서 정의한 필드 값을 가집니다. 행을 열면 세부 보기에서 모든 필드를 확인하고 편집할 수 있으며, 저장할 때마다 행 기록에 새 버전이 생성됩니다.

### 하위 컬렉션

하위 컬렉션은 상위 컬렉션의 각 행 아래에 중첩된 테이블입니다. 스키마에 **하위 컬렉션** 필드를 추가하면 만들어집니다. 예를 들어 "테스트 스위트" 컬렉션에 "테스트 케이스" 하위 컬렉션 필드를 추가하면 각 테스트 스위트 행이 자체 테스트 케이스 테이블을 가지고, 각 테스트 케이스 행이 "테스트 실행" 하위 컬렉션을 가지는 구성도 가능합니다.

## 필드 유형

컬렉션의 각 컬럼에는 다음 유형 중 하나를 설정할 수 있습니다.

| 유형          | 설명                      |
| ----------- | ----------------------- |
| **텍스트**     | 한 줄 텍스트                 |
| **긴 텍스트**   | 여러 줄 텍스트                |
| **URL**     | URL 문자열                 |
| **숫자**      | 숫자 값                    |
| **예 / 아니오** | 불리언 체크박스                |
| **날짜**      | 날짜                      |
| **선택**      | 사용자 정의 옵션의 드롭다운(단일 선택)  |
| **하위 컬렉션**  | 중첩된 행 테이블(위의 하위 컬렉션 참고) |

## 기본 제공 템플릿

새 스페이스를 만들 때 네 가지 기본 제공 템플릿 중에서 선택하거나 빈 상태로 시작할 수 있습니다.

| 템플릿         | 설명                                               |
| ----------- | ------------------------------------------------ |
| **테스트 케이스** | 제목·설명·단계·예상 결과·우선순위·상태 필드를 포함한 테스트 케이스 목록        |
| **테스트 스위트** | 테스트 스위트 → 테스트 케이스 → 테스트 실행의 3단계 계층 구조(모두 하위 컬렉션) |
| **기능 목록**   | 제목·요약·상태 필드를 포함한 간단한 기능 추적기                      |
| **비어 있음**   | 제목 필드만 있음. 스키마를 처음부터 구성합니다                       |

## 스키마 편집

컬렉션의 컬럼은 언제든지 스키마를 편집하여 사용자 지정할 수 있습니다. 컬렉션에서 **열 편집**(연필 아이콘)을 선택하면 스키마 편집기가 열리며, 필드 추가·이름 변경·순서 변경·유형 변경·보관이 가능합니다. 보관한 필드는 테이블과 양식에서 숨겨지지만 데이터는 유지됩니다.

## 행 기록

행을 저장할 때마다 새 버전이 자동으로 기록됩니다. 행을 열고 **기록** 탭으로 전환하면 이전 버전을 확인하고 값을 비교할 수 있습니다. 이전 버전으로 복원하여 변경 사항을 되돌릴 수도 있습니다.

## AI 어시스턴트 및 워크플로 연동

스페이스는 AI가 읽고 쓸 수 있습니다. AI 어시스턴트는 대화 중에 스페이스의 행을 검색하고 내용을 보고할 수 있습니다. 워크플로는 스페이스 데이터를 읽고 쓰기 위한 다음 기본 제공 도구를 사용할 수 있습니다.

| 도구        | 기능                                     |
| --------- | -------------------------------------- |
| 스페이스 목록   | 현재 워크스페이스의 모든 스페이스를 반환합니다              |
| 컬렉션 목록    | 스페이스 아래의 컬렉션 또는 행 아래의 하위 컬렉션을 나열합니다    |
| 스키마 가져오기  | 컬렉션의 현재 컬럼 정의를 반환합니다                   |
| 행 목록      | 컬렉션의 행을 제목과 마지막 업데이트 시간과 함께 나열합니다      |
| 검색        | 스페이스 전체 또는 워크스페이스 전체의 행을 전문 검색합니다      |
| 행 가져오기    | 단일 행의 모든 필드 값을 반환합니다                   |
| 행 만들기     | 컬렉션에 새 행을 추가합니다                        |
| 행 업데이트    | 기존 행의 필드 값을 업데이트합니다(병합 또는 덮어쓰기)        |
| 스페이스 만들기  | 새 스페이스와 첫 번째 컬렉션을 만듭니다                 |
| 컬렉션 만들기   | 스페이스에 최상위 컬렉션을 추가합니다                   |
| 하위 컬렉션 열기 | 행의 하위 컬렉션 필드에 해당하는 테이블을 열고 그 ID를 반환합니다 |

예를 들어 리소스 및 컨텍스트에서 사양을 읽어 테스트 케이스를 생성하고, 스페이스 컬렉션에 직접 기록하는 워크플로를 실행할 수 있습니다.

## 참고 자료

* [스페이스 및 컬렉션 관리](/features-ko/spaces/manage-spaces.md)
* [행 관리](/features-ko/spaces/manage-rows.md)