Skip to content

3S-CREW/Chaining

Repository files navigation

한국인과 외국인의 문화 교류 앱 서비스, 체이닝(Chaining)

한국인과 외국인의 문화 교류 앱 서비스, 체이닝(Chaining)의 팀 개발 저장소입니다.

🌐 앱 다운로드 사이트

[원스토어]

한국인과 외국인의 문화 교류 앱 서비스, 체이닝(Chaining)

📧 문의

Email

🔥3S CREW

AOS AOS
인하대학교 전기전자공학부 20 세종대학교 전자정보통신공학과 20
윤종근 이호섭
@hi2242 @lhs2257
AOS 경험했던 오류, 시행착오 AOS 경험했던 오류, 시행착오
AOS 이론 학습
Firebase 비용 최적화를 위한 노력

📋 Documnets for developer

개발 설명서

🛠️ Tech

Development Tools

Google Analytics Notion


Language & UI

Jetpack Compose UI State Holder


Architecture & Libraries

Hilt Coroutine Retrofit Room


Code Quality

Spotless ktlint


Version Control & Deployment

Onestore

1. 프로젝트 명

한국인과 외국인의 문화 교류 앱 서비스, 체이닝(Chaining)

2. 프로젝트 소개

이번 주말, 외국인 친구와 함께 떠나는 가장 특별한 국내 여행

매번 똑같은 주말, 비슷한 국내 여행에 지루함을 느끼셨나요? 비싼 학원비 없이 '진짜 외국어'를 사용하며 외국인 친구를 사귀고 싶다는 생각, 한 번쯤 해보지 않으셨나요?

Chaining은 여러분을 '여행객'에서 '문화 가이드'이자 '글로벌 친구'로 만들어 드립니다.

K-컬처에 대한 열정을 가지고 한국을 찾은 외국인 친구들에게 여러분만 아는 '진짜 한국'의 명소와 문화를 소개해 주세요. 익숙했던 강원도의 풍경도, 늘 가던 부산의 맛집도 외국인 친구의 새로운 시선을 통해 가장 특별한 여행지가 될 수 있습니다.

딱딱한 교과서는 잠시 잊으세요. 함께 여행하며 웃고 대화하는 사이, 학원에서는 배울 수 없었던 살아있는 외국어 실력이 자연스럽게 향상되는 놀라운 경험을 하게 될 것입니다.

해당 서비스는 한국관광공사의 국문, 영문 API를 제공 받아 제작되었습니다.

3. 프로젝트 Workflows

Image

4. 프로젝트 기획 의도

Chaining은 반복되는 일상과 국내 여행에서 벗어나 새로운 경험을 원하는 사람들을 위해 탄생했습니다.

많은 사람들이 외국어를 배우고 외국인 친구를 사귀고 싶어 하지만 비싼 비용과 시간적 제약, 마땅한 기회의 부재로 어려움을 겪습니다.

저희는 이러한 문제에 대한 해결책으로 여행을 통한 자연스러운 문화 교류를 제시합니다. 한국인은 외국인 친구에게 자신만의 '진짜 한국'을 소개하는 가이드가 되어 여행의 새로운 주인공이 될 수 있습니다. 외국인은 현지인 친구와 함께 K-컬처를 깊이 있게 체험하며 잊지 못할 추억을 만듭니다.

Chaining은 언어와 문화의 장벽을 허물고 '여행'이라는 즐거운 활동을 통해 사람과 사람을 연결하여 서로의 세상을 넓혀주는 경험을 제공하고자 합니다.

5. 프로젝트 기능 소개

🔹 공통 기능

  • 회원가입 및 로그인: 구글 소셜 계정을 통해 간편하게 서비스에 가입하고 로그인할 수 있습니다.
  • 프로필 등록 및 관리: 관심 지역, 사용 가능 언어, 자기소개 등 자신을 표현할 수 있는 프로필을 작성하고 수정합니다.
  • 피드 기능: 한국관광공사에서 제공하는 여행 추천지를 랜덤하게 소개합니다.
  • 언어 기능: 디바이스의 언어 설정에 따라 자동으로 변환되는 서비스를 이용할 수 있습니다.
  • 언어 테스트 기능: 한국어 -> 영어, 영어 -> 한국어에 대한 테스트를 진행하여 프로필 정보에 추가합니다.

🔹 모집자 기능

  • 모집글 등록: 모집자의 여행 계획을 소개하고 지원자를 받을 수 있습니다.
  • 지원서 확인: 지원자가 제출한 지원서를 확인할 수 있습니다.
  • 승인/거절 처리: 승인된 사용자에게 오픈 채팅 링크를 전달합니다.
  • 지원 알림: 알림을 통해 편리하게 지원서 접수 내역을 확인할 수 있습니다.

🔹 지원자 기능

  • 모집글 탐색: 관심 있는 모집글을 목록 혹은 필터링을 통해 확인할 수 있습니다.
  • 지원서 작성: 각 모집글에 맞춰 자신을 소개하고 개별적으로 지원서 작성 및 제출할 수 있습니다.
  • 결과 알림: 앱 내 알림을 통해 모집자의 승인/거절 여부에 대한 알림을 확인할 수 있습니다.
  • 결과 확인: 모집자의 승인 여부에 따라 앱에서 카카오톡 오픈채팅 링크를 확인하고 카카오톡 앱으로 연결이 가능합니다.

6. 프로젝트 시연 GIF

🔹 프로필 관련 Flow
프로필 정보 등록 방법
프로필 등록 방법.gif
언어 테스트 방법
언어 테스트 방법.gif
🔹 지원자 서비스 Flow
커뮤니티 글 확인 방법
커뮤니티 글 확인 방법.gif
신청서 작성 방법
신청서 작성 방법.gif
지원서 결과 확인 방법
지원서 결과 확인 방법.gif
🔹 피드 관련 Flow
국문 버전 피드 확인 방법
국문 버전 피드 확인 방법.gif
영문 버전 피드 확인 방법
영문 버전 피드 확인 방법.gif

7. 프로젝트 전체 아키텍쳐

Image

8. Commit Convention

Tags Explanation
Feat 새로운 기능 추가
Fix 버그 수정
!BREAKING CHANGE 커다란 API 변경의 경우
!HOTFIX 급한 치명적 버그 수정
Build 빌드 관련 파일 수정
Design CSS를 포함 UI 디자인 변경
Docs 문서 수정
Style 코드 포맷팅, 세미콜론 누락, 코드 변경 X
Refactor 코드 리팩토링
Comment 필요한 주석 추가 및 변경
Test 테스트 코드 수정
Rename 파일, 폴더명 이름 수정
Remove 파일, 폴더 삭제
chore 빌드, 패키지 수정

9. 오픈소스 활용

이름 버전 구분 설명 / 역할 라이선스
AndroidX Core KTX 최신 (libs 관리) 라이브러리 Kotlin 확장 함수 제공 Apache-2.0
AndroidX Lifecycle Runtime KTX 최신 라이브러리 Lifecycle + Coroutine 통합 지원 Apache-2.0
AndroidX Activity Compose 최신 라이브러리 Jetpack Compose Activity 지원 Apache-2.0
Jetpack Compose BOM 최신 프레임워크 Compose UI 빌드 기반 Apache-2.0
Material3 (Compose) 최신 프레임워크 구글 Material Design UI 컴포넌트 Apache-2.0
Navigation Compose 2.7.7 라이브러리 Compose 네비게이션 지원 Apache-2.0
Coil (Compose) 2.6.0 라이브러리 이미지 로딩/캐싱 Apache-2.0
Room 2.7.2 라이브러리 로컬 SQLite DB ORM Apache-2.0
Retrofit2 2.9.0 라이브러리 REST API 통신 Apache-2.0
Gson (Retrofit Converter) 2.9.0 / 2.10.1 라이브러리 JSON 직렬화/역직렬화 Apache-2.0
OkHttp Logging Interceptor 4.11.0 라이브러리 HTTP 요청/응답 로깅 Apache-2.0
Kotlin Coroutines 1.8.1 라이브러리 비동기 처리 / 코루틴 지원 Apache-2.0
Kotlinx Serialization JSON 1.8.1 라이브러리 Kotlin 직렬화(JSON) 지원 Apache-2.0
Firebase BoM 33.16.0 프레임워크 Firebase SDK 버전 관리 Apache-2.0
┗ Firebase Database KTX 라이브러리 실시간 데이터베이스 Apache-2.0
┗ Firebase Analytics 라이브러리 앱 분석 Apache-2.0
┗ Firebase Auth KTX 라이브러리 인증 기능 (Google 로그인 등) Apache-2.0
┗ Firebase Storage KTX 라이브러리 파일 업로드/다운로드 Apache-2.0
Google Play Services Auth 21.0.0 라이브러리 구글 로그인 API Apache-2.0
Google Identity Services (googleid) 1.1.0 라이브러리 OAuth 2.0 기반 Google 로그인 Apache-2.0
AndroidX Credentials API 1.5.0 라이브러리 자격 증명 관리 (Google 로그인 연동) Apache-2.0
Hilt (Dagger2 기반) 2.55 프레임워크 의존성 주입 (DI) Apache-2.0
┗ Hilt Navigation Compose 1.2.0 라이브러리 Compose + Hilt 통합 Apache-2.0
JUnit 최신 (libs) 라이브러리 단위 테스트 EPL-1.0
Espresso Core 최신 (libs) 라이브러리 UI 테스트 Apache-2.0
Spotless 6.22.0 코드 포맷터 (ktlint 포함) Apache-2.0
Kotlinx Serialization Plugin 1.9.22 플러그인 @Serializable 애노테이션 지원 Apache-2.0
Kotlin Parcelize Plugin 최신 플러그인 Parcelable 코드 자동 생성 Apache-2.0
Compose Compiler Plugin 2.1.0 플러그인 Compose 컴파일러 확장 Apache-2.0
Google Services Plugin 4.4.3 플러그인 Firebase/Google 서비스 연동 Apache-2.0

10. Version

날짜 내용 VersionName VersionCode
2025.09.15 배포용 프로토타입 Ver.1.0.0 1
2025.09.17 알림 오류 및 기타 오류들 수정 Ver.1.0.1 2
2025.09.19 오류 및 디자인 수정 Ver.1.0.2 3
2025.10.23 오류 수정 Ver.1.0.3 4

License

This project is licensed under the MIT License.

About

한국인과 외국인의 문화 교류 앱 서비스, 체이닝(Chaining)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages