One Server

Docs

문서 사람이 읽는 문서를 AI도 그대로 읽어요

MCP 주소를 연결하면 이 문서가 도구와 함께 전달돼요https://end.blackall.ai/mcp?lang=ko

읽을거리

무엇이 있고 어떻게 동작하는지

01

처음부터 끝까지

도구를 쓰는 순서. 무엇부터 부를지 모를 때 이것부터 읽으세요.

02

Supabase·Vercel에서 옮기기

Supabase나 Vercel로 만든 앱을 옮기는 순서: 데이터베이스, supabase-js, 로그인, 함수, 배포. 그대로 도는 것과 확인할 것.

03

접근 규칙

새 표가 왜 비어 보이는지. 이 플랫폼에서 가장 자주 틀리는 곳이라 먼저 읽으세요.

04

키 세 종류

공개 키·비밀 키·접근 토큰의 쓰임과, 어느 것을 브라우저에 두면 안 되는지.

05

데이터 읽고 쓰기

질의 문법, 연산자, 한글 부분 검색.

06

DB 확장

pgvector(임베딩 검색)와 PostGIS(지도) 같은 확장을 켜고 끄는 법, 켤 수 있는 목록, 공유 데이터베이스에서의 동작.

07

DB 브랜치

git 브랜치마다 미리보기 데이터베이스: 만들기, 미리보기 배포에 연결, 병합, 초기화, 삭제, 요금.

08

대기열 · Vault · GraphQL · 접속 제한

pgmq와 같은 대기열, 데이터베이스 안의 암호화된 비밀(Vault), /graphql/v1, 직접 연결의 주소 제한과 TLS.

09

로그인 붙이기

이메일·비밀번호와 소셜 로그인. 토큰이 어디로 돌아오는지.

10

실시간 구독

표마다 켜야 한다는 것과, 접근 규칙이 실시간에도 걸린다는 것.

11

파일

버킷과 업로드, 공개와 비공개의 차이, S3로 쓰기, Supabase에서 파일 옮기기, 이어 올리기(TUS).

12

환경 변수

배포한 앱에 API 키 같은 값을 넣는 법, 언제 반영되는지, 쓸 수 없는 이름.

13

로그

앱이 오류를 낼 때 무엇이 일어났는지 보는 법. 출처별로 무엇이 남는지.

14

배포

저장소 연결, 프로덕션 브랜치, 모노레포의 빌드 폴더.

15

함수, 예약 작업, 데이터베이스 웹훅

함수 코드의 모양, 할 수 있는 것과 없는 것(외부 요청은 켜야 가능), 호출하는 법, cron 일정(UTC), 표 변경을 외부로 알리는 웹훅.

16

도메인과 엣지

도메인 연결·확인·리디렉트, API용 도메인, 방화벽과 요청 한도, 엣지 캐시.

17

엣지: 분석, 엣지 설정, KV, AI 게이트웨이, 점진적 배포, 미들웨어

사이트 앞에서 도는 것: 개인정보 없는 웹 분석과 속도 측정, 배포 없이 바꾸는 값과 기능 플래그, 키-값 저장소, OpenAI 호환 AI 게이트웨이, 새 배포를 일부 방문자에게 먼저 보내기, middleware.ts.

18

프리뷰 보호

프리뷰 주소를 누가 열 수 있는지, 자동화에서 통과하는 법.

19

한도와 요금

무료는 한 사람의 GitHub 사이트 하나만, 넘으면 거부. 유료는 쓴 만큼 계산.

20

조직: 팀, 알림, 요금, 감사 기록

구성원 초대와 역할, 알림 채널, 청구서, 감사 기록, 그리고 같은 일을 HTTP(/api/v1)로 하는 경로.

21

마이그레이션과 타입

스키마 변경을 버전 붙은 SQL로 적용하고 기록하기, 스키마를 SQL로 내려받기, supabase-js용 TypeScript 타입 만들기.

22

명령줄 도구 (oneend)

터미널과 CI에서 쓰는 oneend 명령: 로그인, 프로젝트 연결, 환경 변수, 배포, 함수, 마이그레이션, 타입.

따라 하는 순서

목적 하나에 필요한 도구를 순서대로

레퍼런스

서버 코드에서 바로 만든 엔드포인트·도구·명령 목록이에요