README.md

👔 terning 터닝 - 대학생 인턴, 공고 관리 캘린더

앱스토어 링크 : 앱스토어 v1.0.4

내 계획에 딱 맞는 대학생 인턴의 시작, 터닝

취업을 위한 필수 관문이자 대학생으로서 쌓을 수 있는 최고의 스펙, 인턴.

학점 관리부터 대외활동까지, 바쁜 일상 속에서 대학생들은 인턴이라는 스펙을 위해 자신만의 계획을 수립합니다.

희망하는 근무 기간과 그 기간 동안 일할 수 있는 기업은 무엇이 있는지, 내가 지원할 공고의 지원 마감일은 언제인지.

팀 터닝포인트는 대학생이 세운 계획에 딱 맞는 인턴 공고를 추천해주고, 인턴 지원 일정을 효율적으로 관리하는 방안에 대해 고민합니다.

터닝에서 나만의 인턴 계획을 등록하고, 딱 맞는 인턴 공고를 추천 받아보세요!

About TerningPoint

지금이 우리의 터닝포인트

서비스 한 줄 소개 : 맞춤형 인턴 추천 및 일정 관리를 통해, 사회인을 향한 대학생의 마지막 터닝포인트를 함께합니다.

🟢 Problem

1. 인턴 일정을 관리하기가 어려움
2. 대기업은 채용공고를 수시로 홈페이지에 들어가야 해서 피로함.
3. 인턴 후기에 대한 객관적인 판단의 어려움 존재.(긍정적인 리뷰가 대부분)
4. 서류제출기한, 면접제출 기한을 한번에 파악하기 힘듦.
5. 홈페이지에 들어갔을 때 직무가 무슨 직무인지, 나랑 잘 맞는 직무인지 직관적으로 알기 어려움 홈페이지에서 공고를 확인할 시, 직무의 정보 결핍, 적합성을 파악하기 어렵다는 점이 존재.

🟢 Solution

1. 간단한 세가지 문답만으로 나만의 대학생 인턴 계획을 입력 -> 이에 맞는 공고를 추천
2. 내 계획에 딱 맞는 인턴 공고를 나만의 커스텀 캘린더로 스크랩하고 관리해보세요.
3. 내가 관심 있는 공고 중 오늘 마감되는 공고를 리마인드 받아보세요.

🧑‍💻 Member

이명진 (@thingineeer)	정민지 (@wjdalswl)	김민성 (@mminny)
홈 화면 캘린더 소셜 로그인 스크랩 공용 컴포넌트	온보딩 소셜 로그인 탐색 공고 상세화면 마이페이지	홈 필터링

🏠 Project Design

📌 Issue Naming Rule

[Prefix] - 이슈내용

ex) [Feat] - TerningPoint 홈 화면 구현

📌 PR Naming Rule

[Prefix] #이슈번호- 작업내용

ex) [Feat] #1 - TerningPoint 홈 화면 구현

⭐️ Commit Message Rule

[prefix] #이슈번호 - 이슈 내용

[Prefix]

[Add]: 기능과 무관한 코드 추가 (라이브러리 추가, 유틸리티 함수 추가 등)
[Chore]: 그 이외의 잡일/ 버전 코드 수정, 패키지 구조 변경, 파일 이동, 파일이름 변경
[Comment]: 필요한 주석 추가 및 변경
[Del]: 쓸모없는 코드, 주석 삭제
[Design]: 뷰 구현 (UI 관련 코드 추가 및 수정)
[Docs]: README나 WIKI 등의 문서 개정
[Feat]: 새로운 기능 구현
[Fix]: 버그, 오류 해결, 코드 수정
[Refactor]: 전면 수정이 있을 때 사용합니다
[Remove]: 파일 삭제
[Setting]: 프로젝트 세팅 및 전반적 기능
[Test]: 테스트 코드

ex) [Feat] #5 - 서버 연결 구현

📑 Code Convention

터닝 코드 컨벤션

📌 Code Review Rule

코드 리뷰를 최대한 빨리 달고 반영하자!

📌 App Store Distribution Rule

[Setting] #issueNumber - VersionNumber 배포

ex) [Setting] #821 - v1.0.0 배포

📌 Git Flow

1. 이슈 생성 (어떤 작업 할 것 인지?)
2. 브랜치 생성
3. 브랜치 add, commit, push → PR 과정 거치기
4. 최소 1명 "Approve" 있어야 merge (리드 외 강제 머지 금지)
5. 머지후 ( 해당 브랜치 바로 제거 )
6. pull 받아서 다음 이슈 진행

📌 Git

충돌 안나게 같은 파일 최대한 작업하지 않기

📖 Development Environment and Using Library

• Development Environment

• 📚 Library

라이브러리	사용 목적	Version	Management Tool
Moya	서버 통신	15.0.3	SPM
SnapKit	UI Layout	5.7.1	SPM
Then	UI 선언	3.0.0	SPM
Kingfisher	이미지 처리	7.12.0	SPM
RxSwift	비동기 처리	6.7.1	SPM
FSCalendar	캘린더 구현	2.8.4	SPM
KakaoSDK	카카오 소셜 로그인 구현	2.22.4	SPM
Inject	SwiftUI 처럼 뷰 디버깅	1.5.2	SPM
Lottie	애니메이션 구현	4.5.0	SPM
Amplitude	데이터 분석	1.9.4	SPM

• 🧱 framework

프레임워크	사용 이유
UIKit	UI 구현

📂 Foldering

└── 📂 Terning-iOS
    ├── 📂 Application
    │   ├── 📂 AppDelegate.swift
    │   └── 📂 SceneDelegate.swift
    ├── 📂 Info.plist
    ├── 📂 Resource
    │   ├── 📂 Assets.xcassets
    │   ├── 📂 Config
    │   ├── 📂 Extension
    │   ├── 📂 Fonts
    │   ├── 📂 Literal
    │   ├── 📂 Lotties
    │   ├── 📂 Protocols
    │   ├── 📂 UIComponents
    │   └── 📂 Utils
    └── 📂 Source
        ├── 📂 Data
        │   ├── 📂 Network
        │   └── 📂 Repository
        ├── 📂 Domain
        │   └── 📂 Model
        └── 📂 Presentation
            ├── 📂 AccountOption
            ├── 📂 Calendar
            ├── 📂 FilteringSetting
            ├── 📂 Home
            ├── 📂 JobDetail
            ├── 📂 Login
            ├── 📂 MyPage
            ├── 📂 Onboarding
            ├── 📂 Profile
            ├── 📂 ProfileImage
            ├── 📂 Search
            ├── 📂 SearchResult
            ├── 📂 SortSetting
            ├── 📂 Splash
            ├── 📂 TabBar
            └── 📂 Welcome

🎨 Design