better-i18n 엔터프라이즈: 로컬라이제이션 인프라를 확장하세요

엔터프라이즈를 위한 better-i18n: 로컬라이제이션 인프라를 확장하세요

제품이 여러 언어로 출시되면 로컬라이제이션은 일회성 프로젝트가 아닌 인프라가 됩니다. 프로그래밍 방식의 접근, CI/CD 통합, 일관된 용어 적용, 번역 완료/보류/누락 현황에 대한 가시성이 필요합니다.

better-i18n은 엔지니어링 팀을 위해 설계된 API 우선 번역 관리 플랫폼입니다. REST API, Content SDK, CLI 도구, MCP 서버, CDN 배포, GitHub 연동 등의 빌딩 블록을 제공하여 로컬라이제이션을 개발 워크플로에 원활하게 통합합니다.

엔터프라이즈 팀이 실제로 얻는 것

API 우선 아키텍처

better-i18n의 모든 기능은 REST API를 통해 사용할 수 있습니다. 내부 도구, CI 파이프라인, 커스텀 워크플로에서 플랫폼을 프로그래밍 방식으로 조작할 수 있습니다:

번역 관리 API (dash.better-i18n.com/api):

Content SDK (@better-i18n/sdk):

로컬라이즈된 콘텐츠 엔트리를 가져오기 위한 Supabase 스타일의 쿼리 빌더입니다:

import { createClient } from "@better-i18n/sdk";

const client = createClient({
  project: "your-org/your-project",
  apiKey: process.env.BETTER_I18N_CONTENT_API_KEY,
});

// 프랑스어로 게시된 블로그 글 가져오기
const { data, total, hasMore } = await client
  .from("blog-posts")
  .eq("status", "published")
  .language("fr")
  .order("publishedAt", { ascending: false })
  .limit(20);

SDK는 의존성 제로, TypeScript로 완전 타입 지정되며, 모든 JavaScript 런타임에서 동작합니다.

CDN 배포

번역은 Cloudflare의 엣지 네트워크에서 다음 URL로 제공됩니다:

https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json

전 세계 100밀리초 미만의 배포 속도. 대시보드 또는 API에서 번역을 업데이트하면 애플리케이션을 재배포하지 않고도 CDN에 즉시 반영됩니다.

GitHub 연동

better-i18n은 리포지토리와 동기화됩니다:

• Webhook 트리거 동기화 — 푸시 이벤트가 번역 파일 업데이트를 트리거
• 풀 리퀘스트 워크플로 — 번역 업데이트를 제어 가능한 PR로 푸시
• 최소 권한 — 구성된 번역 파일 패턴(예: locales/**/*.json)에 대한 읽기/쓰기만 허용
• 완전한 머지 제어 — 번역이 코드베이스에 반영되는 시점은 직접 결정

개발자 워크플로를 위한 CLI

@better-i18n/cli가 개발 프로세스에 통합됩니다:

# React/Next.js 코드에서 하드코딩된 문자열 감지
npx @better-i18n/cli scan --ci

# 로컬 번역 키와 클라우드 프로젝트 비교
npx @better-i18n/cli sync --format json

scan을 프리커밋 훅이나 CI 파이프라인에 추가하세요. sync를 사용하여 릴리스 전에 번역 커버리지를 감사할 수 있습니다.

AI 지원 번역을 위한 MCP 서버

2개의 MCP 서버가 AI 도구를 번역 워크스페이스에 직접 연결합니다:

Claude, Cursor, Windsurf 및 MCP 호환 AI 도구와 함께 사용할 수 있습니다. AI 어시스턴트가 IDE를 벗어나지 않고도 키 생성, 번역 업데이트, 콘텐츠 관리를 수행할 수 있습니다.

보안 및 접근 제어

인프라

• Cloudflare Workers — DDoS 보호가 내장된 엣지 컴퓨팅
• PlanetScale MySQL — 자동 백업이 포함된 서버리스 데이터베이스
• Cloudflare R2 — 번역 파일용 오브젝트 스토리지

암호화

• 저장 시: AES-256 암호화
• 전송 시: 모든 연결에 TLS 1.3

인증

• 대시보드: GitHub OAuth(비밀번호 저장 없음)
• API: bcrypt로 해시된 키를 사용한 Bearer 토큰 인증
• 키 범위 지정: API 키를 특정 프로젝트로 범위 제한 가능
• 키 관리: 대시보드에서 즉시 폐기 가능

접근 제어

• 조직 및 프로젝트 수준의 역할 기반 접근 제어(RBAC)
• 모든 민감한 작업에 대한 감사 로그
• 모든 내부 접근에 대한 최소 권한 원칙

컴플라이언스

투명성 안내: 당사는 아직 SOC 2 Type II 인증을 취득하지 않았습니다. 당사의 인프라 제공업체(Cloudflare, PlanetScale)는 SOC 2 Type II 및 ISO 27001 인증을 보유하고 있습니다. 당사는 이러한 표준에 부합하는 보안 관행을 유지하고 있으며, 자체 인증 취득을 추진하고 있습니다. 자세한 내용은 보안 문서를 참조하세요.

프레임워크 지원

모든 프레임워크 통합은 동일한 번역 키와 네임스페이스를 사용하므로, 웹 앱과 모바일 앱이 단일 소스 오브 트루스를 공유합니다.

멀티팀 번역 관리

네임스페이스 구성

번역을 팀, 기능 또는 콘텐츠 유형별로 구성:

your-org/your-project
├── auth/          → 인증 팀
├── dashboard/     → 프로덕트 팀
├── marketing/     → 마케팅 팀
├── help/          → 지원 팀
└── onboarding/    → 그로스 팀

각 네임스페이스는 독립적인 번역 진행률과 리뷰 워크플로를 가질 수 있습니다.

용어집 관리

브랜드 용어, 제품명, 기술 용어를 한 번 정의하면 모든 번역에서 일관성이 유지됩니다:

• 승인된 용어 — 각 언어에서 제품 용어에 대한 올바른 번역 설정
• 번역 금지 규칙 — 브랜드명, 기술 용어, 약어를 소스 언어로 유지하도록 표시
• 일관성 경고 — 번역자가 미승인 대안을 사용할 때 알림 표시

컨텍스트를 활용한 AI 번역

AI 번역은 용어집과 네임스페이스 컨텍스트를 준수합니다. 다음과 같은 용도로 활용하세요:

• 초안 생성 — AI가 용어 체계를 따르는 번역을 생성하고, 사람 리뷰어가 다듬음
• 대량 번역 — 전체 네임스페이스를 몇 분 만에 새로운 언어로 번역
• 모델 선택 — 품질 요구사항에 따라 GPT-4o, Claude, Gemini, DeepL 중 선택

대규모 조직을 위한 스케일링 패턴

멀티프로젝트 구조

엔터프라이즈 조직은 보통 여러 제품을 보유합니다. 각 제품은 독립된 네임스페이스, 용어집, 팀 접근 권한을 가진 better-i18n 프로젝트를 갖습니다:

your-org/web-app
your-org/mobile-app
your-org/marketing-site
your-org/help-center

Content SDK와 REST API는 동일한 인증으로 모든 프로젝트에 걸쳐 동작합니다.

CI/CD 통합

# .github/workflows/i18n-check.yml
name: Translation Coverage Check
on: [push, pull_request]

jobs:
  i18n:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: npx @better-i18n/cli scan --ci
      - run: npx @better-i18n/cli sync --format json

번역되지 않은 문자열을 도입하는 PR을 차단합니다. 매 푸시마다 번역 커버리지를 감사합니다.

대규모 콘텐츠 관리

Content SDK는 로컬라이즈된 콘텐츠를 위한 헤드리스 CMS 패턴을 지원합니다:

// 독일어로 게시된 모든 도움말 문서 가져오기
const { data: articles, total } = await client
  .from("help-articles")
  .eq("status", "published")
  .language("de")
  .order("updatedAt", { ascending: false })
  .limit(50);

// 저자 관계를 확장하여 단일 문서 가져오기
const { data: article } = await client
  .from("help-articles")
  .language("de")
  .expand("author", "category")
  .single("getting-started");

쿼리 빌더는 불변이며, 완전 타입 지정되고, total과 hasMore 메타데이터가 포함된 페이지네이션 결과를 반환합니다.

아직 제공하지 않는 기능

현재 제공 범위에 대해 솔직하게 안내드립니다:

• SSO/SAML — 아직 미지원. 인증은 현재 GitHub OAuth를 통해 이루어집니다. SSO는 로드맵에 포함되어 있습니다.
• 온프레미스 배포 — 클라우드 호스팅 SaaS 플랫폼입니다. 셀프 호스팅 옵션은 현재 제공되지 않습니다.
• 커스텀 데이터 레지던시 — 데이터는 Cloudflare의 글로벌 네트워크를 통해 처리되고 PlanetScale에 저장됩니다. 리전 고정 호스팅은 아직 지원되지 않습니다.
• 전용 SLA — 금전적 패널티가 포함된 계약상 업타임 SLA는 현재 제공하지 않습니다.

이 중 하나라도 조직에 장애 요인이 된다면, 문의하기를 통해 요구사항과 로드맵 일정에 대해 상의하세요.

시작하기

1. dash.better-i18n.com에서 조직 생성
2. 첫 번째 프로젝트 설정 및 언어 구성
3. CLI 설치 — npm install -D @better-i18n/cli
4. GitHub 연결 — 번역 파일 동기화 활성화
5. MCP 서버 추가 — AI 도구에 번역 접근 권한 부여
6. SDK 통합 — 애플리케이션에서 @better-i18n/next, @better-i18n/use-intl 또는 @better-i18n/expo 사용

무료로 시작하기 — 신용카드 불필요. API, CLI, MCP 서버 및 모든 프레임워크 통합은 모든 플랜에서 이용 가능합니다. 자세한 설정 가이드는 문서를 참조하세요.