01 SOFTWARE

Introduction

01.software Headless CMS - 멀티테넌트 콘텐츠 관리 플랫폼

01.software Headless CMS

01.software는 E-commerce, 콘텐츠, 미디어 관리를 위한 멀티테넌트 Headless CMS 서비스입니다.

주요 기능

기능설명
E-commerce상품, 변형, 옵션, 주문, 결제, 반품 관리
콘텐츠블로그 포스트, 문서, 리치 텍스트 에디터
미디어플레이리스트, 갤러리, 이미지 최적화
멀티테넌트테넌트별 데이터 격리 및 API 키 관리

시작하기

1. SDK 설치

npm install @01.software/sdk
# 또는
pnpm add @01.software/sdk

2. 클라이언트 생성

import { createBrowserClient } from '@01.software/sdk'

const client = createBrowserClient({
  clientKey: 'your-client-key'
})

3. 데이터 조회

// 상품 목록 조회
const response = await client.from('products').find({
  limit: 10,
  where: { status: { equals: 'active' } }
})

if (response.success) {
  console.log(response.data)  // Product[]
  console.log(response.pagination)  // { totalDocs, hasNextPage, ... }
}

자세한 사용법은 빠른 시작 가이드를 참조하세요.

문서 구조

SDK 특징

타입 안전성

모든 컬렉션과 응답에 대해 완전한 TypeScript 지원을 제공합니다.

// 타입이 자동으로 추론됩니다
const response = await client.from('products').find()
// response.data: Product[]

const product = await client.from('products').findById('id')
// product.data: Product

React Query 통합

데이터 페칭과 캐싱을 위한 React 훅을 제공합니다.

import { useCollection } from '@01.software/sdk'

function ProductList() {
  const { data, isLoading } = client.query.useCollection('products', {
    where: { status: { equals: 'active' } }
  })

  if (isLoading) return <div>Loading...</div>
  return <div>{data?.map(p => <div key={p.id}>{p.title}</div>)}</div>
}

서버 클라이언트

Next.js App Router와 완벽하게 통합됩니다.

import { createServerClient } from '@01.software/sdk'

const client = createServerClient({
  clientKey: process.env.NEXT_PUBLIC_SOFTWARE_CLIENT_KEY!,
  secretKey: process.env.SOFTWARE_SECRET_KEY!
})

// Server Component에서 사용
const products = await client.from('products').find()

지원 컬렉션

E-commerce

컬렉션설명
products상품 정보
product-variants상품 변형 (사이즈, 색상 등)
product-options상품 옵션 그룹
product-categories상품 카테고리
orders주문
transactions결제 트랜잭션

콘텐츠

컬렉션설명
posts블로그 포스트
post-categories포스트 카테고리
documents문서

미디어

컬렉션설명
playlists플레이리스트
musics음악 트랙
galleries갤러리

플랜

플랜API 호출/월스토리지사용자
Free10,0001GB3명
Basic100,00010GB10명
Pro1,000,000100GB50명
Enterprise무제한무제한무제한

다음 단계

On this page