학생회와 학생들의 목소리로 함께 만들어가는 대학 생활 필수 앱, 유니보이스 입니다.

• 34기 NOW SOPT APPJAM (2024.06.15 ~ )

박민서	왕정빈	이자민	오연서
[Team Leader] 로그인 퀵스캔 저장 페이지	[Team Member] 회원가입(학생증 후) API 구조 설계 후 구현	[Team Member] 회원가입(학생증 전) 공지사항 등록	[Team Member] 메인 홈 세부공지 확인 마이 페이지

• StyleShare 의 Swift Style Guide를 기본으로 합니다.
• 세부적인 사항은 아래 원칙을 따른다.

- 함수, 메서드 : lowerCamelCase 사용하고, 동사로 시작한다.
- 변수, 상수 : lowerCamelCase 사용한다.
- 클래스, 구조체, enum, extension 등 : UpperCamelCase 사용한다.
- 파일, 클래스 명 약어 사용. 단, UI 선언 구문과 메소드에서는 약어를 사용하지 않는다.
    - 예시) ViewController → `VC`
    - 예시) CollectionViewCell → `CVC`
- 뷰 설정을 위한 함수에서는 set 키워드를 사용한다.
    - 예시) func configureUI → `func setUI`
    - 예시) func setDelegate ... → `func configureDelegate`
- 이외 기본 명명규칙은 [Swift Style Guide]를 참고한다.
- 상속받지 않는 클래스는 final 키워드를 붙인다.
- 단일 정의 내에서만 사용되는 특정 기능 구현은 private 접근 제한자를 적극 사용한다.
- 퀵헬프기능을 활용한 마크업 문법을 활용한 주석을 적극 사용한다.
- 이외는 커스텀한 SwiftLint Rule을 적용한다.
- image asset 추가 시 img_{name}의 이름으로 작성한다. snakecase로 작성
- color asset 추가 시 Figma 네이밍을 따름.

• 모든 파일은 빈 줄로 끝나도록 합니다.

• MARK 구문의 위에만 한 줄 줄바꿈 합니다.

  // MARK: - Layout
  override func layoutSubviews() {
    // doSomething()
  }
  
  // MARK: - Actions
  override func menuButtonDidTap() {
    // doSomething()
  }

• 함수 줄바꿈은 다음과 같이 합니다.

  override func layoutSubviews() {
    // doSomething()
  }

• 함수 정의가 너무 길어지면 다음과 같이 줄바꿈합니다.

  파라미터 기준으로 줄바꿈하며, 리턴은 따로 줄바꿈하지 않습니다.

  func collectionView(_ collectionView: UICollectionView,
                      cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    // doSomething()
  }

• 함수 아래 한 칸, 클래스 아래 한 칸을 줄바꿈하며 의미없는 공백을 만들지 않습니다.

  func 함수1() {
  
  }
  
  func 함수2() {
  
  }

• 코드가 짧아도 줄을 바꿉니다.

  switch ~~ {
  	case 0:
              print("")
  }

• guard문이 짧을 시 한 줄에 다 선언한다.
• guard문이 길 시, 아래와 같이 guard 문을 개행한다.
• 개행 시, else는 guard와 같은 들여쓰기를 적용한다.

guard let user = self.veryLongFunctionNameWhichReturnsOptionalUser(),
      let name = user.veryLongFunctionNameWhichReturnsOptionalName(),
      user.gender == .female 
else { return }

git-flow에 사용되는 브랜치는 총 5개 입니다. 🖐️ (main과 develop, feature 필수 나머지는 optional)
- **main(master)**: 
    제품으로 출시될 수 있는 브랜치    
- **develop(개발)**:    
    다음 출시 버전을 개발하는 브랜치    
- **feature(기능)**:    
    기능을 개발하는 브랜치  
- **release(배포)**:  
    이번 출시 버전을 준비하는 브랜치(보통 QA를 여기서 함)   
- **hotfix(빨리 고치기)**:   
    출시 버전에서 발생한 버그를 수정 하는 브랜치

• [Feat] : 새로운 기능 추가 • 새로운 기능을 추가할 때 사용됩니다. 이전에 존재하지 않았던 새로운 기능이나 기능의 확장을 포함합니다.
• [Fix] : 버그 수정 • 기존 기능의 오류를 수정하는데 사용됩니다. 애플리케이션의 기능 또는 동작이 의도한 대로 작동하지 않을 때 사용됩니다.
• [Docs] : 문서 작성 • 문서를 추가하거나 변경할 때 사용됩니다. 주로 README 파일, 사용 설명서, 주석 등의 변경을 의미합니다.
• [Setting] : 프로젝트 세팅
• [Chore] : 그 이외의 잡일/ 버전 코드 수정, 패키지 구조 변경, 파일 이동, 파일이름 변경
• [Add] : 파일추가, 에셋추가 • 새로운 파일이나 코드의 추가에 사용됩니다. 새로운 파일이나 코드를 프로젝트에 추가할 때 사용됩니다.
• [Design] : UI 디자인을 변경했을 때
• [Refactor] : 전면 수정이 있을 때 사용합니다

├── ci_scripts
│   ├── .swiftlint
├── Application
│   ├── AppDelegate
│   ├── SceneDelegate
│   ├── LaunchScreen
├── Global
│   ├── Extension
│   ├── Literals
│   │   ├── Font
│   ├── Resources
│   │   ├── Assets
│   │   ├── Lottie Animation
│   ├── Utility
│   │   ├── Info.plist
│   │   ├── Config.xcconfig
├── Domain
├── Data
│   ├── DTO
│   ├── Router
│   ├── Base
├── Presentation
│   ├── Scene1
│   │   ├── View
│   │   │   ├── Cell
│   │   ├── ViewController
│   │   ├── ViewModel