🚀 폰스널트레이너

모바일에서 만나 볼 수 있는 PT쌤 - 폰스널트레이너

---

👥 멤버

조수아	팀원 2	팀원 3
FE	FE	FE
GitHub	GitHub	GitHub

📱 소개

폰스널트레이너는 PHONE과 PERSONAL TRAINER의 합성어로,

한 마디로 모바일에서 만나 볼 수 있는 PT쌤 이이에요🧑‍🏫

회원님이 하실 일은 본인에 대해 알려주는 것 딱 하나예요. 아 하나 더! 잘 따라만 오세요 ㅎㅎ

말곤 저, 폰스널트레이너가 다 할게요😉

1️⃣ 주차별 맞춤 식단 플랜/운동 루틴 제공

• 기입해주신 사전 정보에 기반해 아주 구체적인 플랜과 루틴을 매주 제공해드려요🧑‍🏫

2️⃣ 주차별 리포트 제공

• 회원님, 저 잘 따라오고 계신 거 맞죠? 제가 다 확인할거예요👀
• 변화 정도 및 목표 달성률 등을 한 눈에 확인할 수 있는 리포트로 같이 확인해보아요📈

3️⃣ 간편하고 빠른 기록

• 회원님 근데.. 저는 폰 안에 있어서 기록을 안 해주시면 아무것도 몰라요..ㅠㅠ 하나하나 기록하기 귀찮으실 거 알아서 최대한 단순한 절차로 준비해봤어요✍️
• 제공된 내용 그대로 수행하셨다면 체크박스 하나 누르는 걸로 기록이 끝나요✅
• 심지어 운동 루틴은 루틴 타이머 이용 시 수행 내용이 자동으로 기록 된다구요⏰

4️⃣ 확실한 피드백 반영

• 회원님, 이번 주 제 코칭 어떠셨나요? 식단이 너무 빡세서 하루종일 배가 너무 고프셨다고요?🌀 시키는 무게대로 레그 컬 했다가 다음 날 걷지도 못하셨다고요?😵‍💫
• 한 주가 끝나면 솔직하게 회원님의 의견을 남겨주세요📝 꼼꼼히 확인하고 다음 주차에 바로 반영해드릴게요🙌
• 반영된 내용은 주차별 페이지에서 확인하실 수 있어요🪄

📆 프로젝트 기간

• 전체 기간: 2025.06.06 - 2025.MM.DD
• 개발 기간: 2025.07.08 - 2025.MM.DD

🤔 요구사항

For building and running the application you need:

iOS 18.2
Xcode 16.2
Swift 6.0

⚒️ 개발 환경

• Front : SwiftUI
• 버전 및 이슈 관리 : Github, Github Issues
• 협업 툴 : Discord, Notion

🔎 기술 스택

Envrionment

Development

Communication

📱 화면 구성

사진 넣어주세요

사진 넣어주세요

🔖 브랜치 컨벤션

• main - 제품 출시 브랜치
• develop - 출시를 위해 개발하는 브랜치
• feat/xx - 기능 단위로 독립적인 개발 환경을 위해 작성
• refac/xx - 개발된 기능을 리팩토링 하기 위해 작성
• hotfix/xx - 출시 버전에서 발생한 버그를 수정하는 브랜치
• chore/xx - 빌드 작업, 패키지 매니저 설정 등
• design/xx - 디자인 변경
• bugfix/xx - 디자인 변경

🌀 코딩 컨벤션

• 파라미터 이름을 기준으로 줄바꿈 한다.

let actionSheet = UIActionSheet(
  title: "정말 계정을 삭제하실 건가요?",
  delegate: self,
  cancelButtonTitle: "취소",
  destructiveButtonTitle: "삭제해주세요"
)

• if let 구문이 길 경우에 줄바꿈 한다

if let user = self.veryLongFunctionNameWhichReturnsOptionalUser(),
   let name = user.veryLongFunctionNameWhichReturnsOptionalName(),
  user.gender == .female {
  // ...
}

• 나중에 추가로 작업해야 할 부분에 대해서는 // TODO: - xxx 주석을 남기도록 한다.
• 코드의 섹션을 분리할 때는 // MARK: - xxx 주석을 남기도록 한다.
• 함수에 대해 전부 주석을 남기도록 하여 무슨 액션을 하는지 알 수 있도록 한다.

📁 PR 컨벤션

• PR 시, 템플릿이 등장한다. 해당 템플릿에서 작성해야할 부분은 아래와 같다
  1. PR 유형 작성, 어떤 변경 사항이 있었는지 [] 괄호 사이에 x를 입력하여 체크할 수 있도록 한다.
  2. 작업 내용 작성, 작업 내용에 대해 자세하게 작성을 한다.
  3. 추후 진행할 작업, PR 이후 작업할 내용에 대해 작성한다
  4. 리뷰 포인트, 본인 PR에서 꼭 확인해야 할 부분을 작성한다.
  5. PR 태그 종류, PR 제목의 태그는 아래 형식을 따른다.

🌟 태그 종류 (커밋 컨벤션과 동일)

태그	설명
[Feat]	새로운 기능 추가
[Fix]	버그 수정
[Refactor]	코드 리팩토링 (기능 변경 없이 구조 개선)
[Style]	코드 포맷팅, 들여쓰기 수정 등
[Docs]	문서 관련 수정
[Test]	테스트 코드 추가 또는 수정
[Chore]	빌드/설정 관련 작업
[Design]	UI 디자인 수정
[Hotfix]	운영 중 긴급 수정
[CI/CD]	배포 및 워크플로우 관련 작업

✅ PR 예시 모음

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

📑 커밋 컨벤션

💬 깃모지 가이드

아이콘	코드	설명	원문
🐛	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

🏷️ 커밋 태그 가이드

태그	설명
[Feat]	새로운 기능 추가
[Fix]	버그 수정
[Refactor]	코드 리팩토링 (기능 변경 없이 구조 개선)
[Style]	코드 포맷팅, 세미콜론 누락, 들여쓰기 수정 등
[Docs]	README, 문서 수정
[Test]	테스트 코드 추가 및 수정
[Chore]	패키지 매니저 설정, 빌드 설정 등 기타 작업
[Design]	UI, CSS, 레이아웃 등 디자인 관련 수정
[Hotfix]	운영 중 긴급 수정이 필요한 버그 대응
[CI/CD]	배포 관련 설정, 워크플로우 구성 등

✅ 커밋 예시 모음

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

🗂️ 폴더 컨벤션