# Univer Bases 소개

> Univer Bases는 테이블, 필드, 레코드, 수식, 여러 뷰로 구성된 구조화된 데이터 작업 공간을 제공합니다.

- Human documentation: [https://docs.univer.ai/ko-KR/guides/bases](https://docs.univer.ai/ko-KR/guides/bases)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/bases.md](https://docs.univer.ai/ko-KR/guides/bases.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [bases/index.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/index.ko-KR.mdx)

---

## Univer Bases란?

Univer Bases는 Univer Office SDK의 구조화된 데이터 제품입니다. 워크시트 그리드 대신 레코드 집합이 주요 객체인 애플리케이션을 위해 설계되었습니다. 경량 데이터베이스, 콘텐츠 워크플로, 승인 추적기, CRM 형식 테이블, 내부 도구에 적합합니다.

Univer Office SDK는 임베디드 편집기와 헤드리스 콘텐츠 처리를 제공하는 [Web SDK](https://docs.univer.ai/ko-KR/guides/sheets.md), 협업과 파일 가져오기·내보내기를 제공하는 [Server SDK](https://docs.univer.ai/ko-KR/server.md), 에이전트 워크플로를 제공하는 [AI SDK](https://docs.univer.ai/ko-KR/ai.md)로 구성됩니다.

Bases는 독립적인 Web SDK 단위 유형입니다. 핵심 패키지는 테이블, 필드, 레코드, 뷰, 수식 계산, 검색, 명령, 협업 변형을 담당합니다. UI 패키지는 독립형 워크벤치와 기본 제공 뷰를 렌더링합니다.

## 브라우저 호환성

Web SDK는 Chrome 88을 대상으로 컴파일되지만, 이것이 모든 주요 환경을 완벽하게 지원한다는 의미는 아닙니다. Web SDK가 다음 브라우저 및 Node.js 환경에서 원활하게 작동하도록 최선을 다하고 있습니다.

| Edge | Firefox | Chrome | Safari | Electron |
| ---- | ------- | ------ | ------ | -------- |
| >=88 | >=90    | >=88   | >=14.1 | >=12     |

> [!WARNING]
> Web SDK는 `Intl.Segmenter`에 의존합니다. 브라우저 또는 런타임 환경에서 이를 지원하지 않는다면 먼저 해당 polyfill을
> 추가하세요. `@formatjs/intl-segmenter` 사용을 권장합니다.

호환성 문제가 발생하면 먼저 적절한 polyfill을 사용해 해결해 보세요. 문제가 계속되면 언제든지 [이슈를 제출해 주세요](https://github.com/dream-num/univer/issues/new/choose).

## Node.js 호환성

> [!WARNING]
> 참고: 이 내용은 Node.js 환경에서 Web SDK를 실행하는 경우에만 적용되며, Node.js 기반 빌드 도구를 사용해 브라우저에서
> Web SDK를 실행하는 경우에는 적용되지 않습니다.

Web SDK는 Node.js 환경에서 실행할 수 있으며 v18.17.0 이상 버전을 지원합니다.

## 주요 기능

* **테이블, 필드, 레코드**: 각 테이블에 타입이 있는 필드와 순서가 있는 레코드를 저장합니다.

* **여러 보기**: 같은 레코드를 그리드, Kanban, 캘린더, Gantt, 갤러리 보기로 표시합니다.

* **명령 기반 편집**: 모델 변경을 하나의 명령 계층으로 전달하고 권한 및 선택적 기록·협업 통합용 훅을 제공합니다.

* **수식 필드**: Base 필드를 Web SDK 수식 계산 파이프라인에 연결합니다.

* **브라우저 워크벤치**: 보기를 렌더링하고 선택, 편집, 클립보드, 스크롤, 패널을 제공합니다.

* **영속화**: 실행 중인 스냅샷을 직접 변경하지 않고 `IBaseSnapshot`을 생성하고 복원하고 저장합니다.

* [가져오기 및 내보내기](https://docs.univer.ai/ko-KR/guides/bases/features/import-export.md)

* [대시보드 및 피벗 뷰](https://docs.univer.ai/ko-KR/guides/bases/features/dashboard.md)

* [댓글](https://docs.univer.ai/ko-KR/guides/bases/features/thread-comment.md)

* [공동 편집](https://docs.univer.ai/ko-KR/guides/bases/features/collaboration.md)

* [변경 이력](https://docs.univer.ai/ko-KR/guides/bases/features/edit-history.md)

* [레코드, 연결 및 계층](https://docs.univer.ai/ko-KR/guides/bases/features/core/records.md)

* [권한](https://docs.univer.ai/ko-KR/guides/bases/features/core/permissions.md)

## 문서 읽는 방법

화면 왼쪽에는 문서 탐색 메뉴가 있습니다. 문서 페이지는 기초부터 고급 내용까지 순서대로 구성되어 있어 애플리케이션을 만들 때 단계별로 따라갈 수 있습니다. 필요에 따라 원하는 순서로 읽거나 사용 사례에 해당하는 페이지로 바로 이동해도 됩니다. 사이드바 상단에서 Univer Bases를 확인할 수도 있습니다.

화면 오른쪽에는 페이지의 각 섹션으로 쉽게 이동할 수 있는 목차가 있습니다. 페이지를 빠르게 찾으려면 상단 검색창이나 검색 단축키(Ctrl+K 또는 Cmd+K)를 사용하세요.

시작하려면 [빠른 시작](https://docs.univer.ai/ko-KR/guides/bases/getting-started/installation.md) 가이드를 확인하세요.

## 사전 지식

이 문서는 초보자도 쉽게 읽을 수 있도록 작성했지만, Web SDK에 집중해 설명하려면 몇 가지 기본 지식이 필요합니다.

문서를 최대한 활용하려면 JavaScript와 관련 생태계에 대한 기본적인 이해가 있는 것이 좋습니다.

Node.js에서 Web SDK를 실행하려면 Node.js에 대한 기본적인 이해도 필요합니다.

## Univer Bases 확장하기

Web SDK는 필요에 맞게 구성할 수 있도록 높은 확장성을 갖추어 설계되었습니다.

- [Quickstart](https://docs.univer.ai/ko-KR/guides/bases/getting-started/installation.md)

- [라이선스 설정](https://docs.univer.ai/ko-KR/server/license.md)

- [Features](https://docs.univer.ai/ko-KR/guides/bases/features/core.md)

- [API Reference](https://docs.univer.ai/ko-KR/reference/classes/univer.md)
