데구르르 (Degururu)

데구르르는 공이 떨어지며 당첨자를 정하는 핀볼 사다리 게임입니다. 커피 내기, 점심 메뉴 정하기부터 모임과 이벤트까지 가볍고 재미있게 활용해 보세요!

• 플레이: https://degururu.vercel.app/

게임 한눈에 보기

How To Play

1. 참가자 목록에서 인원/개수를 조정합니다.
2. 참가자 설정에서 이름, 이미지, 순서를 편집합니다.
3. 게임 시작으로 전체 공을 동시에 투하합니다.
4. 완료 후 결과 보기에서 선택 결과를 확인/복사합니다.

Quick Start

요구사항:

• Node.js 20+

실행:

npm ci
npm run dev

브라우저: http://localhost:5173

접속/이벤트 분석

• @vercel/analytics 기반으로 페이지 방문(자동)과 핵심 이벤트를 수집합니다.
• PostHog를 선택적으로 함께 붙여 행동 패턴(퍼널/리텐션/코호트) 분석이 가능합니다.
• 수집 이벤트:
  • game_start: 게임 시작
  • result_open: 결과 보기 열기(자동/수동)
  • result_copy: 결과 복사
• 개인정보(이메일/문의 내용/참가자 이름 원문)는 이벤트 payload에 포함하지 않습니다.

프로젝트 구조

src/game        # 물리/시뮬레이션/렌더 로직
src/app         # 앱 상태 결합, 액션, selector
src/ui-react    # React UI 레이어
src/ui          # 비 React 유틸/컨트롤러
api             # 서버리스 API
docs            # 디자인 시스템/문서

문서

• 디자인 시스템: docs/design-system.md
• 개인정보 처리방침: public/privacy-policy.html

기여 가이드

• PR 제목 형식: type: summary (예: feat: 결과 모달 공개 플로우 개선)
• 허용 타입: feat, fix, refactor, chore, docs, test, ci, ui
• PR 본문 섹션 순서:
  • ## 변경 사항
  • ## 검증

라이선스

별도 라이선스 정책이 필요하면 프로젝트 정책에 맞춰 추가하세요.