Documentation
가이드, 튜토리얼, 레퍼런스 문서
카테고리별로 문서를 탐색하세요. 각 가이드는 독립적이며 구문 강조가 적용된 코드 예제를 포함합니다.
추천
퀵스타트
5분 안에 첫 파이프라인을 설치하고 실행하세요.
튜토리얼
CLI schematic과 VSCode 워크플로우로 회로를 만들어 봅니다.
시작하기
코드 예제와 학습 경로를 제공하는 인터랙티브 개요.
예제 탐색기
필터와 소스 코드를 포함한 66개 워크스페이스 예제.
패턴 카탈로그
라이브 코드를 포함한 12가지 검증된 패턴.
역량 보드
라이브 모듈 현황, 버전 관리, 검증 명령어.
시작하기
퀵스타트
Ranvier를 설치하고 5분 안에 첫 타입 파이프라인을 실행하세요.
Hello World
처음부터 Transition과 Axon 파이프라인을 만들어 보세요.
튜토리얼: TODO API
JWT 인증, CRUD, 가드를 포함한 완전한 REST API를 구축하세요.
시작 가이드
개념, 설정, 첫 프로젝트를 다루는 완전한 온보딩 가이드.
시작하기 개요
인터랙티브 개요: 코드 예제와 학습 경로로 첫 파이프라인을 만들어 보세요.
튜토리얼
단계별 튜토리얼: hello-world, CLI schematic, VSCode 확장 워크플로우.
철학 & 아키텍처
소개
Ranvier는 타입 결정 엔진 — 실행, 구조, 제어 흐름.
철학 개요
Opinionated Core, Flexible Edges — 핵심 설계 철학.
설계 철학 (원문)
Ranvier 저장소의 전체 설계 철학 문서.
설계 원칙
핵심 설계 선택에 대한 아키텍처 결정 기록 (ADR).
핵심 패러다임
네 기둥: Transition, Outcome, Bus, Schematic.
왜 Opinionated Core?
제약을 통한 정체성, 학습 곡선, 일관성.
왜 Flexible Edges?
생태계 통합, 점진적 마이그레이션, 사용자 자율성.
경계 맵
핵심과 경계가 만나는 지점.
결정 프레임워크
Ranvier 방식, 생태계 방식, 하이브리드 접근 중 선택.
코드 예제
실전 패턴: 순수 Ranvier, Tower 통합, 하이브리드, 이커머스.
가이드
Bus 접근 패턴
read(), get(), require(), try_require() 메서드 결정 트리.
영속성 운영 런북
체크포인트 복구, PostgreSQL/Redis 저장소 설정, 보상 훅.
OTel 운영 플레이북
OpenTelemetry 수집기 설정, 트레이스 내보내기, 메트릭 설정.
보안 강화
SQL 인젝션 방지, 타이밍 안전 인증, 에러 리다크션, OWASP 대응.
프로덕션 준비 체크리스트
배포 전 체크리스트: 인증, 보안, 관측성, 복원력, CI/CD.
통합
Tower 통합
Tower Service/Layer 미들웨어와 Ranvier Transition 통합.
actix-web 통합
actix-web 핸들러와 추출기에서 Ranvier Transition 사용.
Axum 통합
Axum의 인체공학적 API와 Ranvier의 Schematic 워크플로우 결합.
운영
배포 가이드
Docker 멀티 스테이지 빌드, Kubernetes 매니페스트, 환경 설정.
성능 튜닝
프로파일링, 연결 풀, 비동기 패턴, 릴리스 빌드 최적화.
패턴 카탈로그
재사용 패턴: 사가, 팬아웃/팬인, 유효성 검사 파이프라인 등.
API 안정성 계약
고정된 트레잇, 지원 중단 정책, v1.0 semver 약속.
제품 매뉴얼
Ranvier 매뉴얼
핵심 런타임 가이드: Transition, Outcome, Bus, Axon, Schematic.
CLI 매뉴얼
ranvier-cli의 명령어와 아티팩트 흐름.
VSCode 매뉴얼
ranvier-vscode 설정 및 진단 워크플로우.
심층 분석
HTTP 심층 분석
HTTP Ingress, Router DSL, 바디 핸들링, 미들웨어.
표준 라이브러리
내장 노드: Logic, Flow, Data 카테고리.
영속성 심층 분석
크래시 복구, 영속 어댑터, 사가 패턴.
관측성 심층 분석
Inspector, Prometheus 메트릭, OTLP 트레이싱 파이프라인.
인증 심층 분석
Guard 노드, IAM 프레임워크, 세션 관리 패턴.
운영 심층 분석
설정, 헬스 프로브, 구조화된 로깅, 텔레메트리.
배포 심층 분석
Docker 멀티 스테이지 빌드, Kubernetes 매니페스트, 프로덕션 패턴.
패턴 & 예제
Ranvier 샘플
핵심 예제 재현: typed-state-tree, basic-schematic, hello-world.
CLI 샘플
Schematic 및 Timeline 입력으로부터 CLI 아티팩트 생성.
VSCode 샘플
Circuit View 및 이슈 탐색 워크플로우 재현.
예제 탐색기
티어/카테고리 필터와 학습 경로를 제공하는 인터랙티브 예제 탐색기.
패턴 카탈로그 (인터랙티브)
난이도별 라이브 코드 예제를 포함한 12가지 검증된 패턴.