#Ranvier 샘플 — 공식 예제 트랙

버전: 0.43.0 최종 업데이트: 2026-04-08 적용 대상: ranvier (facade) 카테고리: 패턴과 예제

이 페이지는 Ranvier 예제를 공식 학습 순서로 안내합니다.

핵심은 모든 예제를 한 번에 훑는 것이 아니라, 작은 순서대로 따라가면서 기본 파이프라인에서 현실적인 백엔드 형태, 그리고 공개 레퍼런스 앱까지 자연스럽게 올라가는 것입니다.

#공식 트랙

#1. Hello World

목적:

• 가장 작은 서비스에서 Transition, Axon, Outcome의 형태를 익힙니다.

실행:

cargo run -p hello-world

예상 결과:

• 서버 시작 로그
• 간단한 인사말을 반환하는 타입 안전 파이프라인

다음 단계:

• 튜토리얼: TODO API

#2. 튜토리얼: TODO API

목적:

• CRUD, 타입이 지정된 요청/응답 흐름, HTTP 라우트 연결 방식을 익힙니다.

실행:

cargo run -p reference-todo-api

예상 결과:

• POST /login
• GET/POST/PUT/DELETE /todos

다음 단계:

• 심화 튜토리얼: 결제 파이프라인

#3. Order Pipeline

목적:

• 다단계 워크플로 구조와, Ranvier가 단순 CRUD보다 비즈니스 흐름을 어떻게 더 명시적으로 모델링하는지 익힙니다.

실행:

cargo run -p order-processing-demo

예상 결과:

• validation → inventory → payment → shipping 흐름
• 성공/실패 경로 로그

다음 단계:

• admin-crud-demo

#브리지 예제

#4. Admin CRUD Demo

목적:

• 공식 트랙 다음 단계로, JWT 로그인, SQLite, 페이지네이션, 검색, OpenAPI를 갖춘 익숙한 관리자형 백엔드를 살펴봅니다.

실행:

cargo run -p admin-crud-demo

예상 결과:

• POST /login
• GET /departments
• GET/POST/PUT/DELETE /users
• GET /openapi.json
• GET /docs

이 예제는 다음 질문에 대한 첫 답입니다.

"실무적인 Ranvier 관리자 백엔드는 어떤 모습인가?"

#레퍼런스 앱

브리지 예제 다음에는 목적에 따라 레퍼런스 앱으로 이동합니다.

#Reference Fullstack Admin

목적:

• Ranvier 백엔드와 SvelteKit 프론트엔드를 함께 사용하는 public-only 풀스택 관리자 앱입니다.

실행:

cargo run -p reference-fullstack-admin
cd examples/reference-fullstack-admin/frontend
npm install
npm run dev

#Reference E-commerce Order

목적:

• 보상 처리, 감사, 테넌트 인지 워크플로를 포함한 saga 중심 레퍼런스 앱입니다.

실행:

cargo run -p reference-ecommerce-order

#거버넌스 예제

#Request Governance Demo

목적:

• OpenAPI 표면과는 별도로, JWT 인증, 정책 검사, 감사 로그, 요청 수준 관측성, RFC 7807 스타일 에러를 명시적으로 묶은 운영성 예제를 살펴봅니다.

실행:

cargo run -p request-governance-demo

예상 결과:

• POST /login
• POST /requests
• POST /requests/:id/approve
• 권한 부족 승인 시 403 application/problem+json
• audit event 기록

이 예제는 admin-crud-demo와 다른 질문에 답합니다.

"정책과 에러, 관측성을 명시적으로 배선한 서비스는 어떤 모습인가?"

#어떤 표면을 봐야 하나

#관련 문서

• 퀵스타트
• 튜토리얼: TODO API
• 심화 튜토리얼: 결제 파이프라인
• 예제 탐색기