사이트 데이터베이스: 컬렉션과 레코드
블로그 글, 상품, 이벤트, 예약 요청처럼 바뀌는 내용이 사이트에 있으면 Briks는 프로젝트 자체 데이터베이스에 저장해요. 이 페이지에서는 그 데이터를 어디서 찾는지, 직접 수정하는 방법, 새 레코드를 추가하는 방법, 사본을 내려받는 방법을 알려 드려요.
데이터베이스에 담긴 것
데이터베이스는 사이트가 디자인과 별개로, 바뀌는 정보를 보관하는 곳이에요. Briks는 사이트가 저장하는 종류별로 하나씩 컬렉션으로 나눠요. 수업 신청, 선생님, 블로그 글 같은 식이에요. 각 컬렉션에는 레코드(수업 신청 하나, 선생님 한 명, 글 하나)가 있고, 각 레코드에는 이름, 날짜, 사진 같은 필드가 있어요.
페이지는 사이트가 게시될 때 기록을 읽어 와요. 그래서 기록을 바꿔도 새로 빌드할 필요가 없어요. 스튜디오가 사이트를 다시 게시해 주고, 변경 내용은 몇 분 안에 반영돼요.
프로젝트가 하나를 받는 경우
대부분의 프로젝트는 요청하지 않아도 데이터베이스가 생겨요. 직접 업데이트하는 블로그, 메뉴, 이벤트 목록, 예약 요청을 받는 페이지처럼 무언가를 저장해야 하는 순간 Briks가 만들어 줘요. 스튜디오에서 필요한 것을 말하면 데이터베이스가 유럽 연합 안에 만들어져요.
프로젝트에 데이터베이스가 생기기 전에는 Owner와 Admin만 Database 탭을 볼 수 있고, 거기서 Create database를 선택해 빈 데이터베이스를 만들 수 있어요. 그 외 사용자는 데이터베이스가 생기면 이 탭이 보여요.
Database 탭 둘러보기
탭 위쪽에는 다섯 가지 보기가 있어요.
| 보기 | 보여 주는 내용 |
|---|---|
| Data | 왼쪽에는 컬렉션이 있고 각각 담긴 레코드 수가 표시돼요. 그 옆에는 선택한 컬렉션의 레코드가 보여요. |
| Accounts | 사이트에 방문자용 로그인이 있다면, 사이트에서 계정을 만든 사람들이에요. 아직 가입한 사람이 없으면 화면에 No accounts yet이라고 보여요. 로그인과 결제를 참고하세요. |
| Orders | 사이트가 내 결제 프로세서를 통해 판매한 내역을 최신순으로 보여줘요. 시각, 구매 내용, 금액, 상태, 구매자가 나와요. 환불은 프로세서의 자체 대시보드에서 해요. 첫 판매 전에는 No orders yet이라고 표시돼요. |
| Subscriptions | 회원이 결제하고 갱신되는 요금제예요. 누가 구독했는지, 어떤 요금제인지, 상태, 갱신 또는 종료 시점이 보이고, 진행 중인 요금제의 월 수입도 확인할 수 있어요. 회원은 결제 대행사의 페이지에서 해지하고, 운영자는 대행사의 대시보드에서 해지해요. 로그인과 결제를 참고하세요. |
| Settings | 데이터베이스에 담긴 내용과 보관 위치, 내려받기, 복원 지점, 야간 복사본, 위험 구역이에요. |
컬렉션 아래에 Not shown:으로 시작하는 줄이 나타나면, 사이트가 그 컬렉션을 탭이 읽을 수 없는 방식으로 설명하고 있다는 뜻이에요. 스튜디오에 설명 방식을 고쳐 달라고 요청하세요.
컬렉션 둘러보기
컬렉션 고르기
위치: Database, Data
왼쪽 목록에서 이름을 누르세요. 휴대폰에서는 목록이 위쪽에 가로로 나와요. 오른쪽 목록에는 그 컬렉션의 레코드가 25개씩 보여요.
검색하기
위치: Database, Data
검색창에 입력하고(예:
Search class requests) Search를 누르세요. 다시 전체를 보려면 Clear를 선택하세요.열 기준으로 정렬하기
위치: Database, Data
열 제목을 클릭하면 그 기준으로 정렬되고, 다시 클릭하면 순서가 뒤집혀요. 작은 화살표가 목록이 어느 방향인지 알려 줘요.
페이지 간 이동
위치: Database, Data
레코드가 25개보다 많으면 목록 아래의 Previous와 Next를 사용하세요.
언어 변경
위치: Database, Data
컬렉션이 둘 이상의 언어로 관리되면 검색창 옆에 각 언어 이름이 적힌 버튼이 나타나요. 언어마다 레코드가 따로 있어요.
새로 고침
위치: Database, Data
페이지를 연 뒤에 사이트에 저장된 기록, 예를 들어 새 예약 요청은 컬렉션 이름 옆의 둥근 화살표 Refresh를 누르면 나타나요.
레코드 수정하기
열기
위치: Database, Data
첫 번째 열의 레코드 이름을 클릭하거나, 행 끝의 점 세 개를 열고 Edit을 선택하세요.
필드 변경하기
위치: Edit dialog
각 필드에는 알맞은 입력 방식이 있어요: 텍스트 상자, 작은 도구 모음(굵게, 기울임, 제목, 목록, 인용, 링크)이 있는 서식 있는 텍스트 상자, 숫자, 날짜, 켜고 끄는 스위치, 선택 목록, 다른 컬렉션의 레코드를 고르는 선택기예요. 시간이 있는 날짜는 사용자의 시간대로 표시돼요.
주소와 상태 확인
위치: Edit dialog
레코드마다 페이지가 있는 컬렉션에는 Slug가 나와요. 레코드 주소의 마지막 부분으로, 예를 들면
my-first-post예요. 비워 두면 제목으로 만들어요. Status는 Draft 또는 Published이고, 초안은 게시된 사이트에 나오지 않아요.저장
위치: Edit dialog
Save를 누르세요. 값이 받아들여지지 않으면 필드에 바꿀 내용이 나와요. 잘 되면 Saved라고 표시돼요. 게시된 사이트에는 몇 분 안에 반영돼요.
사진 필드에는 프로젝트 스토리지 안의 사진 경로, /images/cover.webp 같은 사이트 내 경로, 또는 전체 https 주소를 넣어요. 새 사진을 쓰려면 먼저 스토리지에 업로드하고 그 경로를 입력하세요.
기록 추가
추가 버튼을 누르세요
위치: Database, Data
목록 위에서 컬렉션 이름이 붙은 버튼을 누르세요. 예를 들어 Add class request가 있어요. 비어 있는 컬렉션에서는 같은 버튼이 페이지 가운데에도 있어요.
필드 채우기
위치: Add dialog
선택 사항이라고 표시된 필드는 비워 둬도 돼요. 여러 언어로 관리하는 컬렉션에서는 지금 보고 있는 언어로 레코드가 추가돼요.
추가하기
위치: Add dialog
아래쪽에 있는 버튼을 누르세요. 추가 라벨과 같은 이름의 버튼이에요. 레코드가 목록에 들어가고, 상태가 Published이면 몇 분 안에 라이브 사이트에도 나타나요.
변경 사항이 라이브 사이트에 반영되는 속도
레코드를 추가, 변경, 삭제하면 사이트가 자동으로 다시 게시돼요. 처음에는 바로, 그다음부터는 수정 횟수와 관계없이 최대 5분에 한 번이에요. 빌드나 A/B 테스트가 진행 중이면 업데이트는 기다렸다가 몇 분 뒤에 다시 시도해요. 사이트의 첫 게시 전에는 아무것도 게시되지 않아요. 각 변경은 record.changed 웹훅으로 다른 도구에 알릴 수도 있어요.
레코드 내려받기
다운로드는 Database 탭 Settings의 Export 그룹에 있고, 두 행 모두 Paid 태그가 붙어 있어요. 유료 요금제에서 쓸 수 있어요. Free 요금제에서는 각 행에 “Comes with a paid plan.”이라고 표시돼요. 그룹 위의 안내도 같은 내용이고, See what's included 버튼을 누르면 가장 작은 유료 요금제가 나오는 업그레이드 창이 열려요. 요금제는 Billing에서 더 볼 수 있어요.
| 다운로드 | 제공되는 것 |
|---|---|
| Download everything | 모든 컬렉션을 .zip 하나에 담아요. 각 컬렉션의 구성을 설명하는 collections.json 파일 하나와, 컬렉션마다 기록이 담긴 JSON 파일이 하나씩 들어 있어요. |
| 컬렉션을 스프레드시트로 내려받기 | 컬렉션 하나를 CSV로 내보내요: 레코드 id 열, 컬렉션에 있으면 슬러그, 상태, 언어, 날짜 열, 그다음 필드마다 열 하나씩이에요. |
JSON은 다른 소프트웨어가 쉽게 읽는 일반 텍스트 형식이에요. CSV는 모든 스프레드시트 앱에서 열리는 형식이에요. 한 번에 내려받으면 컬렉션당 최대 50,000개의 레코드가 들어 있어요. 컬렉션에 그보다 많이 있으면 .zip에 그 컬렉션을 알려 주는 README.txt가 들어 있고, 나머지는 hello@briks.dev로 문의하시면 돼요.
프로젝트를 볼 수 있는 워크스페이스 구성원은 누구나 다운로드할 수 있고, Viewer도 포함돼요. 프로젝트당 한 시간에 최대 30번까지 다운로드할 수 있어요.
컬렉션 하나를 스프레드시트로 내보내기
앱이 출시된 뒤 마케팅 도움이 필요한 창업자.
위치: Database
Database 탭을 열고 위쪽의 Settings를 선택해요.
컬렉션 선택하기
위치: Settings, Export
Download a collection as a spreadsheet에서 버튼 옆 목록에서 컬렉션을 골라요.
다운로드해서 열기
위치: Settings, Export
Download를 누르세요. 파일 이름은 사이트, 컬렉션, 오늘 날짜를 따서
lotus-room-class_requests-2026-10-08.csv처럼 정해지고, 어떤 스프레드시트 앱에서든 열려요. 레코드 하나가 한 행이에요.
누가 무엇을 할 수 있나요
| 동작 | 할 수 있는 사람 |
|---|---|
| 컬렉션과 레코드 보기 | 워크스페이스의 모든 사람 |
| 레코드 추가, 변경, 삭제 | Editor, Admin, Owner |
| 레코드 다운로드(유료 요금제) | 프로젝트를 볼 수 있는 모든 사람 |
| 복원 지점을 저장하고, 야간 복사를 켜거나 꺼요 | Editor, Admin, Owner |
| 복원하기, 컬렉션 비우기, 데이터베이스 삭제하기 | Owner와 Admin, 프로젝트 이름을 직접 입력해야 해요 |
| 데이터베이스 직접 만들기 | Owner와 Admin |
Viewer가 항목을 열면 읽기 전용으로 보이고, 이런 문구가 나와요: You can look but not change records in this workspace. 역할은 멤버와 역할에서 설명해요.
계정 보기
사이트에 방문자 계정이 있으면 Accounts에 목록이 나와요: 이름과 이메일, 역할, 이메일 확인 여부, 가입일, 마지막 로그인 시각. 이메일이나 이름으로 검색하고 열 제목으로 정렬할 수 있어요. 각 행의 점 세 개 메뉴에는 다음이 있어요:
- Change role: 계정을 Member, Staff, Admin 중 하나로 바꿔요. 사이트의 다음 페이지를 열 때 적용되고, 로그인 상태는 유지돼요. Editor 이상이 할 수 있어요.
- Sign out everywhere: 모든 기기에서 세션을 한꺼번에 종료해요. 비밀번호로 다시 로그인할 수 있어요. Editor 이상만 쓸 수 있어요.
- Delete account: 이메일을 입력하면 해당 사용자의 계정, 비밀번호, 세션을 영구 삭제해요. 사이트에 남아 있는 그 사용자의 다른 데이터는 그대로예요. Owner와 Admin이 할 수 있어요.
예시: 요가 스튜디오의 수업 신청
수업 자리를 신청할 수 있는 페이지를 만들어 줘요: 이름, 이메일, 원하는 수업, 메모. 매일 아침 훑어볼 수 있게 신청을 모두 저장해 줘요.
사이트가 문의 양식과 함께 공개되었고, 프로젝트에 Class requests 컬렉션이 있는 Database 탭이 생겼어요. 방문자가 보낸 요청은 하나하나 그곳에 레코드로 쌓여요.
매일 아침 스튜디오 매니저는 Database를 열고 Class requests를 골라 날짜 열을 클릭해 최신 요청이 위로 오게 해요. 요청을 자세히 봐야 하면 방문자 이름을 클릭해 열어요.
목요일 인 요가 수업 신청이 이메일 주소에 오타가 있는 채로 들어왔어요. 기록을 열어 주소를 고치고 Save를 눌러요.
저장했어요. 게시된 사이트에는 몇 분 안에 반영돼요.
월말에 사장님은 Class requests를 스프레드시트로 내려받아 수업별 신청 수를 세고 다음 시간표를 짜요. 이 다운로드는 유료 플랜이 필요해요.
레코드를 바꿨는데 라이브 사이트에는 이전 내용이 그대로 나와요.
몇 분만 기다려 주세요. 사이트는 최대 5분에 한 번 다시 게시되고, 빌드나 A/B 테스트가 진행 중이면 업데이트가 기다려요. 레코드의 상태가 Draft가 아니라 Published인지 확인하세요.
여기서 필드나 컬렉션을 통째로 추가할 수 있나요?
Database 탭에서는 안 돼요. 스튜디오에서 요청하세요. 예를 들어 수업 신청에 전화번호 필드를 추가해 줘 라고요. Briks는 데이터베이스 구성을 바꾸기 전에 복원 지점을 저장해요.