Skip to content

가천대학교 UMC 7기 장기 해커톤 B팀 iOS

Notifications You must be signed in to change notification settings

UMC-Blism/Blism_iOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍎 Blism_iOS 🍎

가천대학교 UMC 7기 장기해커톤 B팀 Blism iOS 레포지토리입니다.

👶🏼 iOS Members 👶🏼

이수현 (Soo) 송재곤 (Azin) 이재혁 (Ham)
팀장 👑 팀원 👨🏻‍💻 팀원 👨🏻‍💻
내 밑으로 다 꿇어라. 굽신굽신...🙇🏻 �다섯 살은 집에 두고 왔습니다.5️⃣
스플래쉬
온보딩
마이페이지
홈화면
메시지확인
편지 작성
검색창

🛠️ Development Environment 🛠️

iOS Xcode

🥞 Stacks 🥞

Name Description
iOS 앱의 UI를 구축하고 사용자 인터페이스를 관리하는 기본 프레임워크.
분산 버전 관리 시스템으로, 코드 히스토리 관리와 협업을 효율적으로 지원한다.
작업 관리 및 문서화를 위한 통합 협업 도구.
팀 커뮤니케이션 및 실시간 협업을 위한 음성 및 텍스트 기반 플랫폼.

📚 Libraries 📚

Name Version Description
Then 3.0.0 간결하고 직관적인 방식으로 객체를 설정할 수 있게 도와준다.
SnapKit 5.7.1 Auto Layout을 코드로 작성할 때 간단하게 가독성을 높일 수 있다.
Moya 15.0.3 네트워크 요청을 관리하는 데 도움을 주는 Alamofire 기반의 네트워크 추상화 라이브러리.
Kingfisher 8.1.2 URL 기반의 이미지를 효율적으로 다운로드 및 캐싱할 수 있다.

💻 Convention 💻

🔗 Convention Notion Link 🔗

🌲 Branch Convention 🌲

  1. 기본 브랜치 설정

    • main : 배포 가능한 안정적인 코드가 유지되는 브랜치
    • develop: 기본 브랜치로, 기능을 개발하는 브랜치
  2. 작업 순서

    1. 작업할 이슈 작성

    예) #111 사용자 로그인 기능 구현

    1. 작업 브랜치 생성
      • 기능 개발: feature/#[이슈번호]-title
        • ex) feature/#111-login
      • 버그 수정: fix/#[이슈번호]-title
        • ex) fix/#111-login
      • 리팩토링: refactor/#[이슈번호]-title
        • ex) refactor/#111-login
    2. 생성한 브랜치에서 작업 수행
    3. 원격 저장소에 작업 브랜치 푸시
    4. Pull Request 생성
    • develop 브랜치 대상으로 Pull Request 생성
    • 리뷰어의 리뷰를 받은 후 PR을 승인 받고 develop 브랜치에 병합 후 브랜치 삭제

🧑‍💻 Code Convention 🧑‍💻

저희는 Swift Style Guide을 따릅니다.

StyleShare

네이밍 규칙

  • 변수/상수: 카멜케이스 (예: userName)
  • 클래스/구조체: 파스칼케이스 (예: UserProfile)
  • 함수/메서드: 동사로 시작하며 카멜케이스 (예: fetchData())

코드 스타일

  • 명시적 타입 선언: 가능하면 타입 명시 (예: var name : String = “name”)
  • 옵셔널 처리: guardif let을 사용하여 안전하게 언래핑
  • 함수 파라미터: 간결하고 직관적인 이름 사용

💬 Issue Convention 💬

  1. Feature: 기능 추가 시 작성
    • Issue: ✅ Feature
    • 내용: 작업하고자 하는 기능을 입력
    • TODO:
      • 구현 내용 입력
    • ETC: 논의가 필요한 사항이나 참고 내용 작성
  2. Fix/Bug: 오류/버그 발생 시 작성
    • Issue: 🐞 Fix / Bug
    • 내용: 발생한 문제 설명
    • 원인 파악
    • 해결 방안
    • 결과 확인
    • ETC: 논의할 사항 작성
  3. Refactor: 리팩토링 작업 시 작성
    • Issue: ♻️ Refactor
    • 내용: 리팩토링이 필요한 부분 작성
    • Before: 변경 전 상태 및 이유 설명
    • After: 변경 후 예상되는 구조 설명
    • TODO:
      • 변경 내용 입력
    • ETC: 논의할 사항 작성

🫷 PR Convention 🫸

**🔗 관련 이슈**

연관된 이슈 번호를 적어주세요. (예: #123)

---

**📌 PR 요약**

PR에 대한 간략한 설명을 작성해주세요.

(예: 해당 변경 사항의 목적이나 주요 내용)

---

**📑 작업 내용**

작업의 세부 내용을 작성해주세요.

1. 작업 내용 1
2. 작업 내용 2
3. 작업 내용 3

---

**스크린샷 (선택)**

---

**💡 추가 참고 사항**

PR에 대해 추가적으로 논의하거나 참고해야 할 내용을 작성해주세요. (예: 변경사항이 코드베이스에 미치는 영향, 테스트 방법 등)

🙏 Commit Convention 🙏

  • feat : 새로운 기능이 추가되는 경우
  • fix : bug가 수정되는 경우
  • docs : 문서에 변경 사항이 있는 경우
  • style : 코드 스타일 변경하는 경우 (공백 제거 등)
  • refactor : 코드 리팩토링하는 경우 (기능 변경 없이 구조 개선)
  • design : UI 디자인을 변경하는 경우
// Format
[[Type]/#[이슈 번호]]: [Description]

// Example
[feat/#1]: 로그인 기능 구현
[fix/#32]: 로그인 api 오류 수정

📁 Foldering Convention 📁

📦Blism
┣ 📂App                    # 앱의 진입점 (AppDelegate, SceneDelegate)
┣ 📂Models                 # 데이터 모델 폴더
┣ 📂Views                  # UI 레이아웃 폴더
┣ 📂ViewControllers        # ViewController 폴더
┣ 📂Network                # 네트워크 통신 폴더
┣ 📂Service                # 서비스 계층 (Keychain 관리 등)
┃ ┗ 📂Keychain             # Keychain 관리
┣ 📂Extension              # Extension 파일 관리
┗ 📂Font                   # Font 파일 관리

About

가천대학교 UMC 7기 장기 해커톤 B팀 iOS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages