오프라인 이벤트의 새로운 시대를 열 오픈오프

“매번 다른 플랫폼으로 옮겨 다니는 건 이제 그만! 오프라인 이벤트를 탐색 혹은 개설하고 홍보, 신청, 참석 인원 관리까지 한 번에 진행하세요. “

Go to changelog.md

🎪 Features

👀 오프라인 이벤트 추천

공연, 파티, 액티비티 등 관심 분야별 오프라인 이벤트 정보를 한 눈에!

🗺️ 오프라인 이벤트 맵

장소별 오프라인 이벤트 현황을 손쉽게 탐색

🎯 오프라인 이벤트 신청

오프라인 이벤트 신청 미리 입력한 정보의 자동 입력을 통해 편리한 이벤트 신청

📒 이벤트 개설 및 명단관리

오프라인 이벤트 개설부터 이벤트 신청 승인 현황, 입장 현황 등을 파악 가능
QR 코드 입장권 스캔 및 참석 명단 관리까지 한번에!

🎪 Tech Stacks

🎪 Authors

조연주(Yeonju Jo)	황호세(Jose Hwang)
QR코드 인식기능, 알림기능, 이벤트 개설 및 명단관리 페이지, 티켓 페이지	회원가입 & 로그인, 메인페이지, 지도페이지, 마이페이지
@yeonju0110	@JoStar33

🎪 How to Run the Project

1. Clone this repository: git clone https://github.com/Central-MakeUs/OpenOff-Client.git
2. Obtain the necessary environment files (located on the Notion page) and save them in the project directory:
   • .env
   • android/app/google-services.json
   • ios/GoogleService-Info.plist
3. Install project dependencies: yarn
4. Run the app on iOS or Android: yarn ios or yarn android
   
   

🎪 Build

Android

1. Download the release-key.zip from the Notion page.
2. Unzip the file and place it in the following directory: android/app/src.
3. Enter additional code in the signingConfigs section within android/app/src/build.gradle.
4. Update versionCode and versionName as needed.
5. Initiate the build process.

iOS

1. In the project settings, ensure that the Team is correctly set in OpenOff > Signing & Capabilities > Signing.
2. Modify both the Version and Build as necessary.
3. Navigate to Product > Archive to initiate the build process.
   
   

🎪 Folder Structure

📦 OpenOff-Client
	├─ ...
	├─ android	// Android-specific project files.
	├─ ios		// iOS-specific project files.
	├─ src
	│  ├─ apis/		// Responsible for fetching data from APIs.
	│  ├─ assets/		// Static assets (images, fonts, etc.).
	│  ├─ components/	// Reusable UI components.
	│  ├─ constants/	// Constants used throughout the application.
	│  ├─ hooks/		// Custom hooks and queries.
	│  ├─ models/		// Data Transfer Object (DTO) type definitions.
	│  ├─ navigators/	// Navigation-related code.
	│  ├─ screens/		// React Native screens.
	│  ├─ services/		// Integration with third-party services and APIs.
	│  ├─ stores/		// State management using Async Storage and Zustand.
	│  ├─ styles/		// Common styles.
	│  ├─ types/		// Type definitions used by clients.
	│  ├─ utils/		// Utility functions.
	├─ ...

🎪 Commit Convention

option	content
✨ feat	새로운 기능 추가
🐛 fix	버그를 고친 경우
📝 docs	리드미 수정
💅 design	UI, UX 관련 코드 수정
💄 style	코드 format 수정 (not production, UI,UX code)
🫧 refactor	코드 리팩토링 작업
🔧 chore	작은 범위 수정 (ex. 코멘트, 주석)
🚚 move	파일 및 폴더 이름 변경
🚚 rename	파일 및 폴더 삭제
👷 ci	CI/CD 관련 수정사항
🚧 wip	작업중인 사항
✅ test	테스트 코드 관련