🚀 MEETKEY

"언어는 배우고 싶은데, 어색한 시작이 싫을 때! 문화도 나누고 싶고, 진짜 친구를 원할 때!"
밋키(MEETKEY)는 한국인과 외국인이 서로 친구가 되고, 언어와 문화를 자연스럽게 배우는 글로벌 커넥션 플랫폼입니다.

---

👥 멤버

주디	하이빈	블루	제로
iOS	iOS	iOS	iOS
GitHub	GitHub	GitHub	GitHub

📱 서비스 소개

🌏 글로벌 친구를 만나는 가장 안전하고 따뜻한 방법, MEETKEY

"영어 회화 잘하고 싶은데... 어디서 외국인 친구를 만나지?" "한국에 사는 외국인 친구랑 진짜 대화가 통하는 친구가 되고 싶어!"

밋키는 언어 교환을 넘어, 진짜 친구가 되는 만남을 만들어주는 플랫폼입니다. 단순히 언어만 배우는 것이 아니라, 서로의 관심사로 자연스럽게 연결되고 문화와 일상을 나누며 성장할 수 있도록 돕습니다.

💡 Why MEETKEY?

• 📈 폭발적인 니즈: 한국인의 73.8%가 영어 회화 학습을 원하고, 한국 거주 외국인은 265만 명을 돌파했습니다. 하지만 서로를 만날 안전한 창구는 부족합니다.
• 🤝 자연스러운 매칭: 어색한 대화 시작은 그만! 관심사 기반 매칭과 대화 유도 질문 카드로 물 흐르듯 자연스러운 소통을 지원합니다.
• 🛡️ 안전한 커뮤니티: 신뢰할 수 있는 프로필 인증과 신고/차단 시스템으로 심리적 장벽을 낮추고 안전한 교류 환경을 제공합니다.
• 🎨 따뜻한 감성: 딱딱한 학습 앱이 아닌, 귀여운 캐릭터와 따뜻한 오렌지/옐로우 톤의 디자인으로 편안하고 즐거운 경험을 선사합니다.

SERVICE GOAL
한국에 거주하며 외국어를 배우고 싶은 한국인들과, 한국 문화를 사랑하는 외국인들이 심리적 장벽 없이 깊이 있는 교류를 경험하도록 돕는 안전하고 편안한 플랫폼

📆 프로젝트 기간

• 전체 기간: 2026.01.01 - 2026.02.13
• 개발 기간: 2026.01.20 - 2026.02.13

🤔 요구사항

For building and running the application you need:

• iOS 16.0+
• Xcode 15.0+
• Swift 5.9+

⚒️ 개발 환경

• Front: SwiftUI, Combine
• Version Control: Git, GitHub
• Collaboration: Discord, Notion, GitKraken, Figma

🔎 기술 스택

Environment

Development

Communication

📱 화면 구성

로그인 & 온보딩	홈 (매칭)	채팅	마이페이지

🔖 브랜치 컨벤션

1. 브랜치 전략

모든 개발은 dev 브랜치를 기준으로 진행합니다.

• main: 배포 가능한 상태의 최종 코드만 관리합니다.
• dev: 개발 중인 코드가 모이는 곳입니다. (Default Branch)
• feat: 새로운 기능 개발 브랜치입니다.
• fix: 버그 수정 브랜치입니다.

2. 브랜치 명명 규칙

타입/#이슈번호-설명

이슈 번호를 포함하여 어떤 작업인지 명확히 식별합니다.

• feat/#1-login-view
• fix/#3-crash-error
• design/#5-home-layout

🌀 코딩 컨벤션

1. Naming Rules

• Class, Struct, Enum: UpperCamelCase (대문자 시작)
• Variable, Function: lowerCamelCase (소문자 시작)
• Action Function: 동작이 명확한 동사로 시작 (didTap..., fetch...)

2. Architecture (MVVM)

• View: UI 구성과 사용자 입력만 담당
• ViewModel: 비즈니스 로직 담당 (import UIKit 지양)
• Role: 뷰컨트롤러가 비대해지지 않도록 로직 분리에 집중

3. Code Style

• Safe Unwrapping: guard let 또는 if let 사용 (! 지양)
• Function: 단일 책임 원칙 준수 (작게 분리)
• Comment: 복잡한 로직 및 공유 필요한 부분 주석 작성

📁 PR 컨벤션

PR 작성 시 아래 템플릿을 준수합니다.

1. PR 유형: 변경 사항의 종류 체크 ([x])
2. 작업 내용: 구체적인 구현 내용 및 로직 설명
3. 추후 진행할 작업: 다음 단계 계획
4. 리뷰 포인트: 중점적으로 확인받고 싶은 부분
5. PR 태그: 제목에 태그 명시 (예: ✨ [Feat] ...)

📑 커밋 컨벤션

💬 깃모지 가이드

아이콘	코드	설명	원문
🐛	bug	버그 수정	Fix a bug
✨	sparkles	새 기능	Introduce new features
💄	lipstick	UI/스타일 파일 추가/수정	Add or update the UI and style files
♻️	recycle	코드 리팩토링	Refactor code
➕	heavy_plus_sign	의존성 추가	Add a dependency
🔀	twisted_rightwards_arrows	브랜치 합병	Merge branches
💡	bulb	주석 추가/수정	Add or update comments in source code
🔥	fire	코드/파일 삭제	Remove code or files
🚑	ambulance	긴급 수정	Critical hotfix
🎉	tada	프로젝트 시작	Begin a project
🔒	lock	보안 이슈 수정	Fix security issues
🔖	bookmark	릴리즈/버전 태그	Release / Version tags
📝	memo	문서 추가/수정	Add or update documentation
🔧	wrench	구성 파일 추가/삭제	Add or update configuration files.
⚡️	zap	성능 개선	Improve performance
🎨	art	코드 구조 개선	Improve structure / format of the code
📦	package	컴파일된 파일 추가/수정	Add or update compiled files
👽	alien	외부 API 변경 반영	Update code due to external API changes
🚚	truck	리소스 이동, 이름 변경	Move or rename resources
🙈	see_no_evil	.gitignore 추가/수정	Add or update a .gitignore file

✅ 커밋 예시 모음

🎉 [Chore] 프로젝트 초기 세팅
✨ [Feat] 프로필 화면 UI 구현
🐛 [Fix] iOS 17에서 버튼 클릭 오류 수정
💄 [Design] 로그인 화면 레이아웃 조정
📝 [Docs] README에 프로젝트 소개 추가

🗂️ 폴더 컨벤션

MeetKey
├── App
│   ├── MeetKeyApp.swift
│   └── Info.plist
├── Global
│   ├── Data (공통 모델)
│   ├── Resources (Assets, Colors, Fonts)
│   └── Utils (Extensions, Modifiers)
├── Network
│   ├── API (Moya Target)
│   ├── Config (BaseURL, Headers)
│   ├── DTO (Request/Response)
│   ├── Provider (Network Provider)
│   └── Services (Business Logic)
├── Presentation
│   ├── Block
│   ├── Filter
│   ├── Header
│   ├── Home
│   ├── Login
│   ├── MyPage
│   ├── Onboarding
│   ├── Report
│   ├── Report+Block
│   └── VoiceCall
└── Resource
    └── Assets.xcassets