SOPT-iOS

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #llm #machine-learning #deep-learning #linux #windows #awesome #kubernetes #security #mcp #openai

(★ 107)

SOPT 공식 어플리케이션

File Explorer

Download Latest Version (.zip)

- - issue-template.md
- CODEOWNERS
- PULL_REQUEST_TEMPLATE.md
- AllGraph.png
- AppGraph.png
- TestGraph.png
- - Appfile
  - Fastfile
  - Matchfile
  - Pluginfile
  - README.md
- - Config.swift
  - Package.swift
- .gitignore
- .swiftlint.yml
- .tuist-version
- Gemfile
- Makefile
- mise.toml
- package.json
- Workspace.swift
.gitignore
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## SOPT 공식 앱
`2022.09 ~ Now`

### 💫 솝트 활동을 더욱 알차고 즐겁게 !

SOPT는 IT와 벤처 창업에 뜻이 있는 대학생들이 모인 국내 최대 규모의 대학생 연합 IT 벤처 창업 동아리입니다.

SOPT에서 활동하고 있는 회원들도, SOPT의 열정이 되고 싶은 분들도 모두 SOPT에 대해서 더 알아갈 수 있는 서비스예요.

![깃헙 프로젝트 소개 페이지](https://github.com/user-attachments/assets/7d422d0d-0825-47b9-a378-4a3bbd9dce4d)

[앱스토어에서 다운 받기](https://apps.apple.com/kr/app/sopt/id6444594319)

---

### 기능 소개

#### 출석
- SOPT 활동 기수 회원들을 위한 출석 기능을 제공하고 있어요
- 나의 출석 점수와 출결 현황을 확인하고, 실시간으로 출석을 인증해요

#### 공식 홈페이지
- SOPT의 열정이 되고 싶은 분들은 ‘비회원'으로 로그인해서 둘러볼 수 있어요
- 공식 홈페이지와 더불어 활동 후기, 프로젝트 내용, FAQ까지 쉽고 빠르게 확인할 수 있어요

#### 플레이그라운드
- SOPT 회원들만을 위한 플레이그라운드에도 쉽게 접근할 수 있어요
- 활동 멤버와 프로젝트, 그리고 모임 생성과 참여까지 한 번에 가능해요

#### 미션과 랭킹
- SOPT를 제대로 즐기기 위한 ‘솝탬프'도 참여할 수 있어요
- 달성할 수 있는 미션이 있다면 사진과 메모를 업로드하고, 도장을 받을 수 있어요
- 완료한 미션을 모아보고 랭킹을 비교하며 SOPT에서의 추억을 쌓아가봐요!

#### 오늘의 솝마디
- 매일 도착하는 창업 운세, 오늘의 솝마디로 즐거운 하루를 시작해보세요
- 오늘의 창업운을 높여줄 행운의 파트너를 콕 찌르고, 커피챗을 신청해보세요. SOPT인의 여정에 뜻밖의 인연을 가져다 줄지도 몰라요!

#### 콕 찌르기
- 콕 찌르기로 솝트 회원과 더욱 가까워져요
- 나와 공통점이 있는 친구를 찾아 친한 친구, 단짝 친구, 그리고 천생연분이 되어보아요

<br>

<br>

> 📮 미션
  - 솝트를 제대로 즐겨본 사람들이 엄선한 솝트 관련 미션을 확인해 보세요.
  - 달성 가능한 미션이 있다면 사진과 메모를 업로드해 보세요. 귀여운 도장도 받을 수 있어요!
  - 완료한 미션을 모아보며 솝트에서의 추억을 간직해 보세요.

<br>

</div>
  </details>

<br>

> 🍀 오늘의 솝마디
  - 매일 도착하는 창업 운세, 오늘의 솝마디로 즐거운 하루를 시작해보세요.
  - 오늘의 창업운을 높여줄 행운의 파트너를 콕 찌르고, 커피챗을 신청해보세요!
  - 나의 하루를 더욱 빛내줄 부적과 함께, 잊지 못할 특별한 하루를 만들어보세요.

문의사항 및 서비스 의견제안은 언제든지 환영합니다 :)

- 서비스 의견제안 : https://forms.gle/L2HpRCvFMh9VvcA57
- e-mail : makers@sopt.org
- 솝트가 더 궁금하다면? : https://sopt.org

<br>

---

### 📱 App Version
| 날짜 | 버전 | 날짜 | 버전 |
|:--|:--|:--|:--|
| 23.01 | `v1.0.0` | 24.10 | `v2.6.1` |
| 23.01 | `v1.0.1` | 24.11 | `v2.6.2` |
| 23.02 | `v1.0.2` | 25.01 | `v2.6.3` |
| 23.04 | `v2.0.0` | 25.01 | `v2.6.4` |
| 23.04 | `v2.1.0` | 25.03 | `v3.0.0` |
| 23.04 | `v2.1.1` | 25.04 | `v3.0.1` |
| 23.05 | `v2.1.2` | 25.05 | `v3.0.2` |
| 23.05 | `v2.1.3` | 25.05 | `v3.0.3` |
| 23.09 | `v2.2.0` | 25.05 | `v3.0.4` |
| 23.10 | `v2.2.1` | 25.06 | `v3.0.5` |
| 23.12 | `v2.2.2` | 25.06 | `v3.0.6` |
| 24.01 | `v2.3.0` | 25.09 | `v4.0.0` |
| 24.06 | `v2.4.0` |  |  |
| 24.08 | `v2.5.0` |  |  |
| 24.10 | `v2.6.0` |  |  |

<br>

### 🛠 개발 환경 및 라이브러리
[![swift](https://img.shields.io/badge/swift-5.0-orange)]() [![xcode](https://img.shields.io/badge/Xcode-15.0-blue)]() [![tuist](https://img.shields.io/badge/Tuist-3.12.0-purple)]() [![Moya](https://img.shields.io/badge/Moya-15.0.0-yellow)]() [![Then](https://img.shields.io/badge/Then-2-gray)]() [![Kingfisher](https://img.shields.io/badge/Kingfisher-7.0.0-red)]() [![Snapkit](https://img.shields.io/badge/SnapKit-5.0.0-yellow)]() [![Quick](https://img.shields.io/badge/Quick-5.0.0-green)]() [![Nimble](https://img.shields.io/badge/Nimble-10.0.0-green)]() [![Lottie](https://img.shields.io/badge/Lottie-4.1.3-orange)]() [![Inject](https://img.shields.io/badge/Inject-1.2.3-skyblue)]() [![Sentry](https://img.shields.io/badge/Sentry-362d59?style=flat-square&logo=Sentry&logoColor=white)]()

<br>

### ⛳️ 로드맵
- [x] Tuist 기반 Clean Architecture Project 세팅
- [x] Fastlane, Makefile 세팅
- [x] 로그인 플로우
- [x] SOPT-AMP
- [x] 마이페이지
- [x] 앱 메인
- [x] 웹 프로덕트 라우팅
- [x] 출석
- [x] 푸시 알림
  - [x] 딥링크, 웹링크 라우팅
- [ ] Makers Design System
  - [x] Toast
  - [ ] Dialog
  - [x] Color
  - [x] Typography
- [x] 콕 찌르기
- [x] 솝트로그
- [x] 인증중앙화(인증 방식 변경)
- [x] Coordinator 리팩토링
  - [x] Coordinator의 Router 의존성 제거
  - [x] Coordinator의 deinit 방식 변경
- [ ] WKWebView로 전환

<br>

### 🏡 Skills

#### Clean Architecture + MVVM Pattern
![MVVM](https://github.com/sopt-makers/SOPT-iOS/assets/77267404/1ce3aab2-e2bd-49a5-9d64-f56ce95389f8)

- Presentation, Data, Domain Layer를 분리하여 계층 내외의 의존성을 효율적으로 관리합니다.
- MVVM Pattern으로 UI와 비즈니스 로직을 분리합니다.

#### Combine Reactive Programming
- 애플의 기본 API인 Combine을 이용하여 반응형 프로그래밍을 구현합니다.
- 비동기 처리를 직관적이고 편리하게 구현합니다.

#### Factory Pattern과 Dependency Injection
<img width="1978" height="761" alt="image" src="https://github.com/user-attachments/assets/e46d4fac-0ec4-4448-91c5-1da042ca8ed6" />

- 각 Feature의 Builder가 Factory의 역할을 수행하여 뷰와 뷰모델을 추상화한 Presentable을 생성합니다.
- 이 과정에서 VC, ViewModel, UseCase, Repository를 주입합니다.

#### Coordinator
![image](https://github.com/sopt-makers/SOPT-iOS/assets/77208067/87495359-42d5-4f19-bdb9-a3ed299f9fba)

- 화면 전환을 Coordinator가 책임집니다.
- Coordinator는 UINavigationController로 직접 화면전환을 수행합니다.
- VC → ViewModel → Coordinator의 참조 관계에 따라 VC가 해제되면 Coordinator도 메모리에서 해제됩니다.
- 대신 Coordinator가 Factory를 참조하여 Presentable을 생성하고 런타임에 클로저 주입으로 화면 전환 시 액션을 지정합니다.

#### Modular Architecture
![graph_after_web_2024 10 28](https://github.com/user-attachments/assets/e399f5e7-c15c-4eef-aa6f-b9bb04571d81)

- SOPT-iOS 앱은 Makers App 팀과 Makers 운영 서비스 팀의 공동 작업물입니다.
- 목적조직의 형태이기 때문에, 각 Feature 간의 독립적인 개발 환경을 보장하기 위해 Feature Interface를 도입했습니다.
- 모듈을 분리하여 응집도 높고 결합도가 낮은 코드를 작성할 수 있는 환경을 구현합니다.
- Demo 타겟을 통해 개발 환경과 테스트 환경을 분리합니다.

#### Tuist
- Tuist를 이용하여 다양한 모듈을 Mono Repo에서 구현합니다. 모듈 및 개발 환경을 편리하게 관리할 수 있습니다.

#### Testability
- 전반적으로 Testable한 코드를 지향합니다.
- 이러한 이점을 살려, Unit Test를 작성하고 신뢰성 및 유지보수성을 확보합니다.

<br>

---

### 🚙 Getting Started

Fastlane과 Makefile을 활용하여 번거로운 개발 환경 세팅을 자동화하고 있습니다.

공개하지 않아야 하는 파일들과 배포를 위한 인증서들은 Private 레포지토리에 있으며 이 곳에 초대를 받은 사람이라면 명령어 1줄을 입력하면 자동으로 모든 환경이 세팅됩니다.

#### 사전 준비
- Fastlane을 설치합니다. ([가이드](https://docs.fastlane.tools/getting-started/ios/setup/))

#### 설치
1. 현재 레포지토리를 Fork 합니다.
2. Fork한 레포지토리를 Clone 합니다.
   ```sh
   git clone https://github.com/your_username_/Project-Name.git
   ```
3. 프로젝트 경로로 이동하고 다음과 같이 입력합니다.
   ```sh
   fastlane start_project
   ```
4. 이제 터미널에서 입력을 요청하는 정보를 입력하고 기다리면 모든 세팅이 완료됩니다.

#### 프로젝트에 기여하고 싶다면?
1. 현재 레포지토리에 Issue를 생성합니다.
2. Fork 한 레포지토리에서 브랜치를 생성합니다.
3. 해당 브랜치에서 작업을 진행합니다.
4. Push 및 Pull Request를 작성합니다.
5. 1명 이상 코드 리뷰 및 Approve를 받은 뒤 develop 브랜치에 Merge 합니다.

<br>

---

### 🍏 Contributors
| <img src="https://user-images.githubusercontent.com/81167570/213436276-c1887933-0c9d-4540-b0e2-7bb7f8f110da.jpeg" width=120/> | <img src="https://user-images.githubusercontent.com/81167570/213436338-6778dd31-a614-464b-a730-8f3cec93ec8e.jpeg" width=120 /> | <img src="https://user-images.githubusercontent.com/81167570/213436397-ab386305-6171-4c3e-acd1-afd78c9456de.jpeg" width=120/> | <img src="https://user-images.githubusercontent.com/81167570/213436015-e9bcce7d-45f2-49d8-a9cd-d1a31f511eba.jpeg" width=120 /> | <img src="https://user-images.githubusercontent.com/77208067/233848222-85097d90-c2e2-4c10-94ee-71910d6e0cbd.jpeg" width=120 /> | <img src="https://user-images.githubusercontent.com/77208067/233848225-2aaad9eb-84ef-47bc-b164-eceb78cf85b0.jpeg" width=120 /> 
|--|--|--|--|--|--|
| [윤수빈](https://github.com/devxsby)| [이세진](https://github.com/lsj8706) | [이준호](https://github.com/L-j-h-c)| [양수빈](https://github.com/yangsubinn)| [김영인](https://github.com/0inn)| [이승호](https://github.com/elesahich) |
| `1, 2, 3기`  | `1, 2, 3, 4기`  | `1, 2기`  |  `1기`  |  `2, 3기` | `2, 3, 4기` |
| <img src="https://github.com/user-attachments/assets/46c2fb55-9bb5-4e52-bc38-6d7a16021332" width=120 />  | <img src="https://github.com/user-attachments/assets/75a54aa5-e456-44e3-80f1-87b39b5defed" width=120 />  | <img src="https://github.com/user-attachments/assets/49001a52-8077-4715-9f05-4d5ef196f723" width=120 />  |  <img src="https://github.com/user-attachments/assets/4fb4c616-49c3-49ee-a1dd-9ecb734bfbab" width=120 />  |  <img src="https://github.com/user-attachments/assets/0e8475e1-e8db-458c-a426-ce33834908b3" width=120 /> |  <img src="https://github.com/user-attachments/assets/26e5eb26-c1f4-4903-bd81-3a6a256ad917" width=120 />  |
|  [김민재](https://github.com/ffalswo2)   |  [강윤서](https://github.com/yungu0010)   | [김승찬](https://github.com/seungchan2)  |  [이재현](https://github.com/dlwogus0128)  |  [장석우](https://github.com/meltsplit) | [최주리](https://github.com/juri123123) |
| `4기`  | `5, 36, 37, 38기`  | `5기`  |  `5, 36, 37기`  |  `5, 36기` | `37, 38기` |
| <img width="120" height="120" alt="image" src="https://github.com/user-attachments/assets/582cb185-dab3-4560-be9f-4d3ca6c47c83" /> | <img src="https://github.com/user-attachments/assets/be65610b-a006-429f-9e7a-3c9828c8a521" width=120 /> |   |    |   |  |
|  [성현주](https://github.com/hye0njuoo)   |  [권석기](https://github.com/kwonseokki)  |  |   |  | |
| `37기`  | `38기` |   |    |   |  |

<br>

SOPT-iOS

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

SOPT-iOS

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README