웹사이트 번역 및 현지화: Base44 — 플랫폼 가이드

1. 올바른 프로젝트 만들기

GoLocal → New Project → Base44에서 정확한 게시 호스트와 필요한 본인 소유 미리보기 도메인만 등록하세요. 원본 언어는 작성한 UI 언어(예: 영어)이며 방문자나 고객 기록 언어가 아닙니다. 위젯 언어와 한도를 확인하세요. 공개 프로젝트 키만 쓰고 Base44 토큰, 모델·DB 비밀키는 쓰지 마세요. Origin은 관리자 인증이 아닙니다.

2. 허용된 편집 방식 선택

압축을 풀고 README.txt를 읽으세요. 공식 생성 채팅에 ai-editor-prompt.txt와 실제 helper/provider 파일을 함께 제공하고 diff를 검토하세요. 테스트 계정의 수동 Code 편집·ZIP 내보내기는 유료 플랜이 필요했고 생성은 기존 크레딧을 썼습니다. 본인 권한을 확인하며 한도 우회나 이 안내만을 위한 업그레이드는 하지 마세요.

Base44 → Code Tab ↗

3. 공개 경계 명확히 설정

두 파일을 함께 두고 public-layout-example.jsx를 기존 공개 셸에 병합하세요. 공개 DOM 뒤에 provider 하나를 마운트합니다. #golocal-public 하나에 공개 내비게이션·제목·페이지만 둡니다. 비공개 경로·포털은 밖에 둡니다. 저장된 고객 이름·설명은 수집 전에 data-user-content / data-gl-private, 참조는 data-gl-record-id로 제외하세요. 전체 body 스크립트 추가나 SDK 인증·라우터 교체는 금지합니다.

// Merge into your EXISTING PUBLIC shell; copy both supplied source files first.
import GoLocalPublicProvider from './integrations/GoLocalPublicProvider.jsx';

// Exactly one #golocal-public wraps only authored public content.
// Private routes/portals stay outside. Do not replace your router/auth gates.
// Mount once after the committed public DOM:
<GoLocalPublicProvider projectKey="YOUR_PROJECT_KEY" />

// Disable: remove this import/mount, rebuild, Publish and fully reload.
// The adapter pins runtime 1.3.2 + SRI; do not add another script.

<span>Source name</span>
<span data-user-content translate="no">Travail à domicile</span>
<div id="golocal-private-host" data-gl-private translate="no" />

4. 번역 문구 대신 ID로 필터링

데모는 objects와 nf-object-01을 유지하고 프랑스어로 Objets와 La Bouilloire n°4를 보여줍니다. 자체 공개 검색은 입력을 바꾸지 않고 bouilloire로 해당 항목을 찾습니다. 모든 Base44 입력의 자동 역번역이 아닙니다. Bubble GoLocal Query는 Base44 컴포넌트가 아닙니다.

en

Objects · The Kettle No. 4

fr

Objets · La Bouilloire n°4

ID / category

nf-object-01 / objects

Input → result

bouilloire → nf-object-01

6. 게시·검증·비활성화

빌드·검토 후 명시적으로 Publish하고 샌드박스뿐 아니라 게시 URL을 새로고침하세요. root·loader·widget 각 하나, runtime 1.3.2와 SRI를 확인합니다. 악센트 입력, 저장 이름, 필터, SPA, 지연 콘텐츠, 수동 수정, 캐시 재방문을 테스트하세요. 끄려면 provider import/마운트만 제거하고 다시 빌드·게시·전체 새로고침해 GoLocal 요청이 없는지 확인하세요. script 태그 삭제는 실행 중인 엔진을 중지하지 않습니다. 검토한 레이아웃을 기록에서 복구해 다시 켭니다.

7. 범위·비용·남은 검증

어댑터는 무료이고 GoLocal SaaS·Base44 호스팅/코드 권한은 별도입니다. 제거는 결제 해지나 번역 삭제가 아닙니다. 비공개 SDK 첫 진입, 인증 경계의 지연 응답, 독립 계정, 엄격한 CSP, 전체 접근성, 실제 기기, 넓은 RTL은 검증이 남았습니다. 실험실 비공개 패널은 인증이 아닙니다. SEO 언어 URL·결제/이메일 번역·검색 순위를 보장하지 않으며 같은 내용에 번역기를 중복 적용하지 마세요.

보안: 네이티브 스캐너는 비밀 노출로 분류했지만 설명은 SRI가 해시이며 하드코딩 비밀이 없다고 했습니다. 경고를 무시하거나 해제하지 않았으며 깨끗한 보안 검사 인증이 아닙니다. SRI를 끄거나 SDK 인증을 무작정 바꾸지 말고 자신의 보고서를 확인하세요.