3. 데이터베이스 관리
데이터베이스는 PropSheet에서 데이터를 저장하는 핵심 단위입니다. 이 장에서는 데이터베이스의 개념부터 생성, 편집, 삭제, 복제, 이동, 즐겨찾기까지 모든 DB 관리 기능을 안내합니다.
3.1 데이터베이스란?
PropSheet에서 데이터베이스(DB)는 하나의 스프레드시트 테이블을 의미합니다. Excel의 시트 하나, 또는 Airtable의 테이블 하나와 같은 개념입니다.
- 행(Row) = 레코드(Record): 하나의 데이터 항목입니다. 예를 들어 매물 하나, 고객 한 명, 일정 하나가 각각 하나의 레코드입니다.
- 열(Column) = 필드(Field): 데이터의 속성입니다. 예를 들어 "주소", "가격", "면적" 등이 각각 하나의 필드입니다.
- 셀(Cell): 특정 레코드의 특정 필드 값입니다. 행과 열이 만나는 지점입니다.
하나의 워크스페이스 안에 여러 개의 데이터베이스를 생성할 수 있습니다. 예를 들어 "금토부동산" 워크스페이스 안에 "매물 관리", "고객 관리", "일정 관리" 등 용도별로 DB를 만들어 운영할 수 있습니다.
| 용어 | 스프레드시트 비유 | PropSheet에서의 의미 |
|---|---|---|
| 워크스페이스 | Excel 파일(.xlsx) | 관련 DB들을 묶어 관리하는 공간 |
| 데이터베이스 | 시트(Sheet) 탭 | 하나의 테이블. 자체적인 필드/레코드/뷰를 가짐 |
| 레코드 | 행(Row) | 데이터 한 건 (매물 1개, 고객 1명 등) |
| 필드 | 열(Column) | 데이터 속성 (주소, 가격, 면적 등) |
3.2 데이터베이스 생성
워크스페이스 화면에서 "새 데이터베이스" 버튼을 클릭하면 DB 생성 모달이 열립니다. PropSheet은 3종의 템플릿을 제공하여 용도에 맞는 DB를 빠르게 만들 수 있습니다.
3.2.1 DB 템플릿 3종
빈 데이터베이스
아무 데이터 없이 기본 필드 3개만 포함된 빈 DB를 생성합니다. 자유롭게 필드를 추가/삭제하여 원하는 구조를 만들 수 있습니다.
- 텍스트 필드 (text 타입) — 짧은 텍스트를 입력하는 기본 필드
- 숫자 필드 (number 타입) — 숫자 값을 입력하는 필드
- 수식 필드 (formula 타입) — 다른 필드를 참조하여 자동 계산하는 필드
캘린더 DB
일정 관리에 최적화된 14개 필드가 자동 생성됩니다. 생성 즉시 캘린더 뷰로 일정을 관리할 수 있습니다.
- 일정제목, 날짜, 시작시간, 종료시간, 장소, 참석자
- 일정유형(단일선택: 미팅/계약/현장답사/기타)
- 상태(단일선택: 예정/진행중/완료/취소), 우선순위(단일선택: 높음/보통/낮음)
- 반복여부(체크박스), 알림설정, 메모(장문텍스트), 관련매물, 첨부파일
Proptalk 통화요약 DB
Proptalk(음성 통화 서비스)의 통화 기록을 자동으로 가져오는 특수 DB입니다. Proptalk에서 통화가 완료되면 통화 요약 데이터가 이 DB에 자동으로 레코드로 추가됩니다.
3.2.2 DB 기본 정보 설정
템플릿을 선택한 후 다음 정보를 입력합니다.
| 항목 | 필수 여부 | 설명 |
|---|---|---|
| DB 이름 | 필수 | 데이터베이스의 이름. 워크스페이스 내에서 구분할 수 있는 명확한 이름을 입력합니다. 예: "매물 관리", "고객 DB", "2026년 일정" |
| Slug | 자동 생성 | URL에 사용되는 고유 식별자. DB 이름 기반으로 자동 생성되며, 영문 소문자/숫자/하이픈만 사용됩니다. 필요 시 직접 수정 가능합니다. |
| 설명 | 선택 | DB의 용도나 포함하는 데이터에 대한 간단한 설명. 팀원들이 DB의 목적을 파악하는 데 도움이 됩니다. |
| 아이콘 | 선택 | DB 카드에 표시될 이모지 아이콘. 시각적으로 DB를 구분하는 데 유용합니다. 예: 🏠(매물), 📅(일정), 👤(고객) |
워크스페이스 화면에서 "새 데이터베이스" 버튼을 클릭합니다.
사용할 템플릿을 선택합니다 (빈 DB / 캘린더 / Proptalk 통화요약).
DB 이름을 입력합니다. Slug는 자동 생성되며, 필요 시 수정합니다.
선택 사항으로 설명과 아이콘을 설정합니다.
"생성" 버튼을 클릭하면 DB가 만들어지고 워크스페이스 화면에 DB 카드가 추가됩니다.
3.3 데이터베이스 편집
이미 생성된 데이터베이스의 기본 정보를 수정할 수 있습니다. DB 카드의 메뉴(⋯) 버튼 또는 DB 상세 화면의 설정에서 편집할 수 있습니다.
변경 가능 항목
- DB 이름: 언제든 변경 가능합니다. 변경 즉시 모든 화면에 반영됩니다.
- 설명: DB의 용도 설명을 추가하거나 수정합니다.
- 아이콘: DB 카드에 표시되는 이모지를 변경합니다.
unique_id 복사
각 데이터베이스는 시스템에서 자동 부여하는 고유 ID(unique_id)를 가집니다. 이 ID는 API 연동, 공유 링크 생성, 기술 지원 요청 시 필요할 수 있습니다. DB 편집 화면에서 unique_id를 클립보드에 복사할 수 있습니다.
3.4 데이터베이스 삭제
더 이상 필요하지 않은 데이터베이스를 삭제할 수 있습니다. DB 카드의 메뉴(⋯)에서 "삭제"를 선택합니다.
데이터베이스를 삭제하면 다음 항목이 모두 영구 삭제됩니다.
- 모든 레코드 — DB에 저장된 모든 데이터 행
- 모든 첨부파일 — 레코드에 업로드된 이미지, 문서 등 물리적 파일
- 모든 뷰 — Grid 뷰, Calendar 뷰 등 설정한 모든 뷰
- 필드 정의 — 필드 구조, 수식, 선택 옵션 등 모든 스키마 정보
삭제 전 반드시 중요한 데이터가 없는지 확인하세요. 필요하다면 삭제 전에 DB 복제로 백업을 만들어 두는 것을 권장합니다.
삭제할 DB 카드의 메뉴(⋯) 버튼을 클릭합니다.
"삭제"를 선택합니다.
확인 대화상자에서 "삭제 확인"을 클릭합니다. 이 시점에서 모든 데이터가 영구 삭제됩니다.
3.5 데이터베이스 복제
기존 데이터베이스를 복제하여 동일한 구조와 데이터를 가진 새 DB를 만들 수 있습니다. 백업 용도 또는 유사한 구조의 DB를 빠르게 만들고 싶을 때 유용합니다.
복제 범위
DB 복제 시 다음 항목이 모두 복사됩니다.
| 항목 | 복제 여부 | 설명 |
|---|---|---|
| 필드 구조 | 복제됨 | 모든 필드의 이름, 타입, 순서, 너비가 동일하게 복제됩니다. |
| 필드 정의(field_definition) | 복제됨 | 수식, 선택 옵션, 날짜 형식 등 필드별 세부 설정이 복제됩니다. |
| 레코드 데이터 | 복제됨 | 모든 행의 데이터가 새 DB에 복사됩니다. 새 record_id가 부여됩니다. |
| 뷰 설정 | 복제됨 | Grid 뷰, Calendar 뷰 등 설정한 모든 뷰가 복제됩니다. |
| 첨부파일 | 복제 안됨 | 레코드에 업로드된 물리적 파일은 복제되지 않습니다. 파일 경로 텍스트만 복사됩니다. |
같은 워크스페이스 내 복제
복제할 DB 카드의 메뉴(⋯) 버튼을 클릭합니다.
"복제"를 선택합니다.
복제 대상 워크스페이스로 현재 워크스페이스를 선택합니다 (기본값).
"복제" 버튼을 클릭하면 "원본이름 (복제)" 라는 이름으로 새 DB가 생성됩니다.
다른 워크스페이스로 복제
복제할 DB 카드의 메뉴(⋯) 버튼을 클릭합니다.
"복제"를 선택합니다.
복제 대상 워크스페이스 드롭다운에서 다른 워크스페이스를 선택합니다. 본인이 editor 이상 권한을 가진 워크스페이스만 표시됩니다.
"복제" 버튼을 클릭하면 선택한 워크스페이스에 새 DB가 생성됩니다.
3.6 데이터베이스 이동
데이터베이스를 현재 워크스페이스에서 다른 워크스페이스로 이동할 수 있습니다. 복제와 달리 원본이 현재 워크스페이스에서 사라지고 대상 워크스페이스로 옮겨집니다.
이동할 DB 카드의 메뉴(⋯) 버튼을 클릭합니다.
"이동"을 선택합니다.
이동 대상 워크스페이스를 드롭다운에서 선택합니다. 본인이 editor 이상 권한을 가진 워크스페이스만 표시됩니다.
"이동" 버튼을 클릭하면 DB가 대상 워크스페이스로 이동됩니다.
- 복제: 원본은 그대로 유지됩니다. 새 사본이 대상 워크스페이스에 생성됩니다.
- 이동: 원본이 현재 워크스페이스에서 사라집니다. 대상 워크스페이스에서만 접근할 수 있습니다.
3.7 즐겨찾기
자주 사용하는 데이터베이스를 즐겨찾기에 등록하면 워크스페이스 화면 상단에 우선 표시되어 빠르게 접근할 수 있습니다.
즐겨찾기할 DB 카드의 별표(☆) 아이콘을 클릭합니다.
별표가 채워진 상태(★)로 변하며 즐겨찾기가 등록됩니다.
즐겨찾기를 해제하려면 채워진 별표(★)를 다시 클릭합니다.