Today Bike 투데이 바이크

● Beta Cycling Tech Rails 8 SQLite Stimulus Turbo Kakao OAuth

A full-stack Rails 8 operations platform for bicycle repair shops — managing service workflows, parts inventory, before/after photo galleries, and a QR-linked bicycle passport system. Live at asan.bike. 자전거 정비소를 위한 Rails 8 풀스택 운영 플랫폼 — 서비스 워크플로우, 부품 재고, 전후 사진 갤러리, QR 연동 자전거 여권 시스템을 통합 관리. asan.bike에서 서비스 중.

Problem 문제 정의

📋
No Digital Workflow디지털 워크플로우 부재
Bike shops relied on paper records for service tracking, leading to lost history and scheduling errors.자전거 정비소가 종이 기록으로 서비스 이력을 관리해 분실과 일정 오류가 빈번했음.
🖼️
No Before/After Record전후 기록 부재
Technicians had no structured way to document repair quality with photos tied to service records.정비 전후를 사진으로 서비스 기록에 연결해 품질을 문서화할 체계가 없었음.
🔧
Inventory Blindspot재고 사각지대
Parts and products had no digital catalog, making reordering and stock tracking guesswork.부품과 제품에 디지털 카탈로그가 없어 재고 파악과 발주가 경험에만 의존했음.

Approach 접근 방식

🚂
Rails 8 Monolith with HotwireRails 8 모놀리스 + Hotwire Leverages Rails 8's built-in Solid Queue, Action Cable, and Active Storage together with Stimulus + Turbo to deliver SPA-like interactions without a separate frontend build step. Kakao OAuth handles authentication, and SQLite provides zero-config local persistence ideal for a single-shop deployment. Rails 8의 내장 Solid Queue, Action Cable, Active Storage와 Stimulus + Turbo를 결합해 별도 프론트엔드 빌드 없이 SPA 수준의 인터랙션을 구현. Kakao OAuth로 인증 처리, SQLite로 설정 없는 로컬 영속성 확보 — 단일 매장 배포에 최적.

Features 주요 기능

01
Service Workflow Engine서비스 워크플로우 엔진
6 service type state machines (inspection, repair, tune-up, custom build, cleaning, parts replacement) with Turbo-powered real-time status updates and technician assignment.6가지 서비스 유형(점검, 수리, 튜닝, 커스텀 빌드, 세척, 부품 교환) 상태 머신을 Turbo 실시간 업데이트와 기술자 배정으로 운영.
02
Before & After Gallery전후 사진 갤러리
Active Storage-backed photo gallery with before/after tagging per service record. Photos are compressed and served via direct upload to avoid server load.Active Storage 기반으로 서비스 기록마다 전/후 태깅 사진 갤러리. 다이렉트 업로드로 서버 부하 없이 압축 저장.
03
Operations Dashboard운영 대시보드
Daily/weekly revenue, service completion rates, technician utilization, and pending work queue — all updated via Turbo Streams with no full-page reloads.일별/주별 매출, 서비스 완료율, 기술자 가동률, 대기 작업 현황 — Turbo Streams로 전체 리로드 없이 실시간 갱신.
04
Products & Parts Catalog + QR Passport부품 카탈로그 + QR 자전거 여권
Digital catalog for 20+ domain models covering parts, brands, and accessories. Each bicycle gets a QR-linked passport page showing full service history on scan.부품, 브랜드, 액세서리를 아우르는 20개 이상 도메인 모델의 디지털 카탈로그. 자전거마다 QR 연동 여권 페이지로 전체 서비스 이력 즉시 조회.

Architecture 아키텍처

Client Server External Service Database Browser Stimulus + Turbo Rails 8 Action Cable Solid Queue Active Storage Photo Gallery Kakao OAuth Authentication SQLite Local Persistence File Storage Direct Upload

Metrics 성과 지표

Domain Models
20
models
Service Types
6
workflows
QR Passport
Bicycle
per bike
Live At
asan.bike
production

Before / After 도입 전후 비교

AspectBeforeAfter
Service tracking Paper records, prone to loss Digital workflow with state machine
Photo evidence Unstructured, phone camera only Before/after gallery per service record
Inventory Memory-based, no catalog 20+ model digital catalog
Bike history Verbal recall per customer QR scan → full service passport
Tech Stack
Rails 8 SQLite Stimulus Turbo Kakao OAuth Active Storage Solid Queue Action Cable