Barbelic devdocs

Barbelic개발 문서

바벨아래 모든순간 — 아키텍처 · RPC · 식별자 · 제품 정책 · 화면 계약의 단일 지도

작업 전 필독 — 설계·완료 원칙

PRD — 제품 요구사항

RPC 카탈로그

릴리스 프로세스

작업 → release → staging → main. 로컬 CI, 두 번의 승격 검증, 배포 순서와 전환 상태.

PRD

현재 구현에서 역추출한 제품 요구사항 스냅샷 — 기능 영역별 요구사항과 구현 상태, 정본 문서 링크.

RPC 카탈로그

supabase/schema.sql의 함수 전수 목록 — 화면 읽기·쓰기·관리자·비동기 잡 RPC와 내부 함수 부록.

BRID 시스템

Barbelic Resource ID — 통일 식별 문자열의 문법, lineage, UUID 파생, 동결 경계.

종목 UUID 식별자

종목 정체성을 UUID 단일 식별자로 고정한 ADR — slug/별칭 우회 금지의 근거.

아키텍처

도메인·서비스 경계, 세션 위계(하루 > 세션 > 종목 > 세트), 데이터 로딩 전략, read model.

제품 정책

e1RM · 종목 모델 · 최대 반복수 · 세트 목적 · wodup 재인입 — 통계 의미론의 버전 관리 정본.

이 사이트에 대해

이 사이트는 레포 docs/ 트리를 그대로 렌더링한 것이다. 정본은 언제나 레포의 마크다운 원문이며, ⚙ 표시가 붙은 문서는 스크립트·테스트가 원문을 직접 읽어 검증하므로 사이트를 위해 고쳐 쓰지 않는다.

전체 목차와 "언제 어떤 문서를 읽나"는 문서 지도에서.
에이전트 작업 규범 최상위 요약은 AGENTS.md에서.
모든 작업의 착수·재개 전 설계·작업 완료 원칙을 읽는다.

한국어 번역본

영어로 작성된 문서 26편은 원문을 그대로 두고 ko/ 아래에 한국어 번역본을 따로 뒀다. 왼쪽 사이드바는 번역본을 가리키며, 각 번역본 상단 배너에서 원문으로 갈 수 있다.

원문을 번역으로 대체하지 않은 이유는 두 가지다. 테스트·스크립트가 원문 문장을 직접 읽어 검증하는 ⚙ 문서가 있고(app-screen-rpc-contract, stats-refresh-jobs, exercise-identity-hard-cutover, typescript-migration-scope), docs/policies/*/versions/** 는 CI가 변경을 거부하는 불변 스냅샷이다. 계약·게이트 판단이 갈리면 언제나 원문을 따른다.