Barbelic devdocs

Appearance

Barbelic 브랜드와 활성 식별자 ​

앱과 사용자 노출 문구에서 사용하는 정식 제품명은 첫 글자 B를 대문자로 쓴 Barbelic이다. 문장 첫머리, 앱 표시명, 웹 메타데이터, 문서와 안내 문구에 모두 같은 표기를 사용한다.

2026-09-08 사용자 지시로 소문자 제품명을 강제하던 규칙과 브랜드 표기 검사 게이트를 폐지했다. 이 문서가 과거 문서와 업데이트 기록의 브랜드 표기 지침을 대체한다.

정식 명칭 ​

  • 제품명과 앱 표시명: Barbelic
  • private npm 패키지명: barbelic
  • 공개 웹의 정규 주소: https://www.barbelic.com
  • GitHub 저장소: dekerd/Barbelic
  • 기존 공개 브랜드 에셋 파일명: barbelic-* (파일 경로 식별자)

www.barbelic.com은 운영 주소이자 OAuth Site URL이다. barbelic.com, barbelic.app, www.barbelic.app은 정규 주소로 308 리디렉션한다.

제품의 표시명과 기술 식별자는 별개다. URL·이메일·npm 패키지·저장소 및 파일 경로· Xcode scheme·bundle ID·OAuth scheme·JS/API·DB source·storage key는 기존 값을 유지한다. 소문자 제품명을 요구하는 게이트나 테스트를 추가하지 않는다.

약관·개인정보처리방침 v2–v4의 표시 제품명도 Barbelic으로 정정했다. 동의 버전, 시행일, 조항 내용, 링크는 그대로다. 법률 문서 무결성 검사는 HTML 텍스트 노드의 제품명 첫 글자 정정만 허용하며 그 밖의 수정·삭제·이름 변경은 계속 차단한다.

브랜드 마크 자산 ​

  • 정본 원본: src/react/ui/desktop/assets/brand/barbelic-mark-source-1254.png
  • 웹 파비콘·Apple Touch Icon: public/icons/barbelic-mark-20260812-{64,180}.png
  • PWA 설치 아이콘: public/icons/barbelic-mark-20260812-{192,512}.png
  • 데스크톱 화면 마크: src/react/ui/desktop/assets/brand/barbelic-mark-20260812-192.png
  • iOS AppIcon: ios/App/App/Assets.xcassets/AppIcon.appiconset/AppIcon-512@2x.png
  • Android 런처 아이콘: android/app/src/main/res/mipmap-*/ic_launcher.png(정사각 축소)와 mipmap-*/ic_launcher_foreground.png(검정 바탕 adaptive 전경, 마크를 안전 영역에 맞춰 축소)

2026-08-12 업로드된 검정 바탕의 그라데이션 B 비트맵을 정본으로 사용한다. 파생본은 투명도를 만들거나 배경을 바꾸지 않고 정사각 RGB PNG로만 축소한다.

iOS 새 앱 하드 컷오버 ​

iOS 앱은 기존 설치본의 업데이트가 아니라 다음 식별자를 사용하는 새 앱으로 배포한다.

  • bundle ID: com.dekerd.barbelic
  • product 및 표시명: Barbelic (빌드 산출물 Barbelic.app)
  • Xcode/Capacitor 공유 scheme: barbelic (내부 target과 Swift module은 App)
  • OAuth callback: barbelic://auth/callback
  • Info.plist 설정 키: BarbelicServerOrigin, BarbelicSupabaseAuthOrigin, BarbelicCallbackScheme
  • xcconfig 키: BARBELIC_SERVER_ORIGIN, BARBELIC_SUPABASE_AUTH_ORIGIN, BARBELIC_CALLBACK_SCHEME
  • iOS 웹 브리지: barbelicNative, barbelic:native-*, __barbelicNative*
  • Keychain service: com.dekerd.barbelic.auth
  • 네이티브 로그인 거래 저장 키: barbelic.native-auth.*

이 경로에는 이전 bundle ID, custom scheme, Keychain service, JS handler/event에 대한 fallback, 이중 등록 또는 데이터 이관을 두지 않는다. Apple Developer와 App Store Connect에는 새 App ID와 앱 레코드를 만들고, Supabase Redirect URLs에는 barbelic://auth/callback**을 별도로 등록한다.

Android 앱도 같은 식별자를 쓴다: applicationId·namespace com.dekerd.barbelic, 표시명 Barbelic, OAuth callback barbelic://auth/callback, BuildConfig 키 BARBELIC_SERVER_ORIGIN·BARBELIC_SUPABASE_AUTH_ORIGIN·BARBELIC_CALLBACK_SCHEME, Keystore 별칭·SharedPreferences 이름 com.dekerd.barbelic.auth.

웹과 iOS·Android는 모두 https://www.barbelic.com을 사용한다. Vite 산출물은 dist-vite에 만들고 Capacitor도 같은 디렉터리를 동기화한다.

이번 iOS 컷오버와 분리된 역사·데이터 계약 ​

과거 migration, 고정 정책 snapshot, 이미 게시된 법률 v1 문서는 재현성과 감사 무결성을 위해 그대로 둔다. DB/RLS 이름, provenance 값, 정책 ID, 기존 브라우저 IndexedDB 이름과 내부 서비스 모듈명은 iOS 앱의 bundle 또는 네이티브 callback 식별자가 아니며, 데이터 스키마를 함께 마이그레이션하는 별도 작업 없이 기계적으로 치환하지 않는다. 이 값들은 새 iOS 앱에 대한 호환 fallback으로 사용되지 않는다.

공개 중인 terms-v1.html과 privacy-v1.html은 동의 버전이 고정된 법률 문서로 보존한다. terms-v2.html과 privacy-v2.html은 현재 제품명과 정규 도메인을 반영한다. v2는 서비스 내용과 개인정보 처리 범위를 바꾸지 않으므로 기존 v1 동의 사용자에게 강제 재동의를 요구하거나 v2 동의 이력을 임의 생성하지 않는다.