From 54d1e7e1f8426e719f2bb0bae04140b046090eae Mon Sep 17 00:00:00 2001 From: Soomin Kim Date: Wed, 11 Feb 2026 21:23:54 +0900 Subject: [PATCH 1/2] =?UTF-8?q?[docs]=20README=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 276 +++++++++++++++++++++++++++--------------------------- 1 file changed, 137 insertions(+), 139 deletions(-) diff --git a/README.md b/README.md index 1c06e40..83ba158 100644 --- a/README.md +++ b/README.md @@ -1,109 +1,108 @@ -# image 포티 -> 복잡한 분철 과정을 한눈에 정리하고, 믿을 수 있는 거래로 자연스럽게 이어주는 플랫폼 +# image -image +스크린샷 2026-02-09 오후 10 52 50 +## 🌀 포티 소개 -### `분철 과정을 한눈에 정리하고,믿을 수 있는 거래로 이어주는 앱` +> 흩어진 분철 정보와 불투명한 참여 현황을 정리해, 원하는 분철을 빠르고 투명하게 참여할 수 있도록 돕는 서비스 +> -
+### 분철이란? -### 팀원 구성원 및 역할 분배 +팬덤 문화에서 원하는 멤버의 굿즈를 갖기 위해 **물품을 공동 구매하여 나누는 행위** -| 김나연(Lead) | 로그인, 마이페이지, 모집/참여 내역 | -| --- | --- | -| 김수민 | 홈, 굿즈별 페이지, 분철팟 상세, 참여자 정보 | -| 박정환 | 등록페이지, 아티스트 검색 페이지, 멤버 편집 바텀시트 | -| 이서현 | 모집/참여 상세 내역, 참여자 관리 페이지 | +현재의 분철은 **플랫폼 이동 + 반복 소통**이 필수인 비효율적인 구조 -
+- 분철 정보가 여러 곳에 흩어져 있어 탐색이 어렵습니다. +- 진행 상황을 수동으로 체크하고, 입금/배송 상태를 개인의 기억에 의존해야 합니다. +- 신뢰 판단 기준이 없어 모집자와 참여자 모두 피로도가 높습니다. +### 포티는 이렇게 해결해요 -## 🍎 iOS Developer +1. 검색의 비효율 -> `옵션 기반 검색 · 아이돌 굿즈 추천 시스템`으로 해결합니다. +2. 진행 관리의 불편함 -> `진행 상황 상태바 · 참여자 관리 페이지`로 해결합니다. +3. 신뢰와 안전에 대한 불안 -> `EMA 별점 시스템 도입 · 거래 이력 기반 신뢰도 시스템`으로 해결합니다. -| **[김나연](https://github.com/Yeonnies)** | **[김수민](https://github.com/gleamminn)** | **[박정환](https://github.com/Jhw9n)** | **[이서현](https://github.com/doitexactly)** | -| :---: | :---: | :---: | :---: | -| | | | | -| `iOS Lead Developer` | `iOS Developer` | `iOS Developer` | `iOS Developer` | +## 🌀 포티 주요기능 +주요기능 -
+
+ +## 🍎 iOS Developer + +| [김나연](https://github.com/Yeonnies)
iOS Lead Developer | [김수민](https://github.com/gleamminn)
iOS Developer | [박정환](https://github.com/Jhw9n)
iOS Developer | [이서현](https://github.com/doitexactly)
iOS Developer | +| :---: | :---: | :---: | :---: | +| | | | | +| `스플래시/로그인` `온보딩`
`마이페이지` `모집/참여 내역` `프로필` | `홈` `굿즈별 페이지`
`분철팟 상세` `참여` | `등록` `아티스트 검색` | `모집 상세 내역` `참여 상세 내역`
`참여자 관리` | +
## 🛠️ Tech Stack & Library - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
기술 / 라이브러리목적
UIKit안정적이고 풍부한 레퍼런스, 우수한 호환성, 예측 가능한 UI 레이아웃 작업
MVVMUI, 비즈니스 로직 분리를 통해 화면 상태 변화를 명확하게 관리, 유지보수성 강화
Clean Architecture도메인 중심의 의존성 분리를 통해 변경에 강하고 확장 가능한 구조 구축
Alamofire간결한 네트워크 요청과 구조화된 관리 방식으로 코드 가독성과 유지보수성 향상
Combine비동기 데이터 흐름을 선언적으로 관리, 상태 변화에 따른 UI 업데이트 처리
Snapkit간편한 Auto Layout 적용
ThenUI 코드 작성시 편의성 향상
Kingfisher효율적인 이미지 다운로드 및 캐싱을 통해 네트워크 이미지 로딩 성능 향상
LottieJSON 기반 애니메이션 활용을 위해 사용
Logger구조화된 로깅을 지원하여 성능 저하 없이 효율적으로 로그 수집 및 분석 가능
KakaoOpenSDK카카오 소셜 로그인을 위해 사용
Swift Concurrency명확하고 안전한 비동기 흐름 관리를 통해 복잡한 비동기 로직의 가독성과 유지보수성 향상
기술 / 라이브러리목적
UIKit안정적이고 풍부한 레퍼런스, 우수한 호환성, 예측 가능한 UI 레이아웃 작업
MVVMUI, 비즈니스 로직 분리를 통해 화면 상태 변화를 명확하게 관리, 유지보수성 강화
Clean Architecture도메인 중심의 의존성 분리를 통해 변경에 강하고 확장 가능한 구조 구축
Alamofire간결한 네트워크 요청과 구조화된 관리 방식으로 코드 가독성과 유지보수성 향상
Combine비동기 데이터 흐름을 선언적으로 관리, 상태 변화에 따른 UI 업데이트 처리
Snapkit간편한 Auto Layout 적용
ThenUI 코드 작성시 편의성 향상
Kingfisher효율적인 이미지 다운로드 및 캐싱을 통해 네트워크 이미지 로딩 성능 향상
LottieJSON 기반 애니메이션 활용을 위해 사용
Logger구조화된 로깅을 지원하여 성능 저하 없이 효율적으로 로그 수집 및 분석 가능
KakaoOpenSDK카카오 소셜 로그인을 위해 사용
Swift Concurrency명확하고 안전한 비동기 흐름 관리를 통해 복잡한 비동기 로직의 가독성과 유지보수성 향상

-## 주요 기능 소개 - -`원하는 굿즈 분철팟 탐색하기`
-`불필요한 소통없이 간편하게 분철 참여하기`
-`분철팟 모집글 등록하기`
-`분철 진행 상황 한눈에 관리하기`
- -
- - ## 📁 Foldering + ``` 📁 Poti-iOS ├── 📁 Application @@ -145,73 +144,71 @@ ├── 📁 Resource │ │ ├── Assets.xcassets │ │ └── 📁 Fonts - ``` -## 아키텍쳐 설계 -image - -
- -## 프로젝트 설계 -IMG_9004 PNG +## 🎨 Project Design +image +IMG_9004 PNG ## 📣 Convention + ### Code Style + [Swift Style Guide](https://github.com/StyleShare/swift-style-guide)를 따릅니다. ### Commit -**- Tag** + +- **Tag** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
태그사용하는 부분
[feat]새로운 기능 구현
[fix]버그, 오류 해결
[chore]코드 수정, 내부 파일 수정 등 중요도가 낮은 기타 작업
[add]라이브러리 또는 에셋 추가
[del]쓸모없는 코드 삭제
[docs]README나 WIKI 등의 문서 개정
[refactor]기존 코드 리팩토링 또는 구조 개선
[setting]프로젝트 관련 설정 변경
[merge]Pull Develop
태그사용하는 부분
[feat]새로운 기능 구현
[fix]버그, 오류 해결
[chore]코드 수정, 내부 파일 수정 등 중요도가 낮은 기타 작업
[add]라이브러리 또는 에셋 추가
[del]쓸모없는 코드 삭제
[docs]README나 WIKI 등의 문서 개정
[refactor]기존 코드 리팩토링 또는 구조 개선
[setting]프로젝트 관련 설정 변경
[merge]Pull Develop
+- **Message** -**- Message** ``` (커밋 메세지 형식) [종류] #이슈번호 - 작업 내용 @@ -220,13 +217,14 @@ [feat] #1 - 메인 UI 구현 (Conflict 해결 시) -[merge] #이슈번호 - Conflict 해결 +[merge] #이슈번호 - Conflict 해결 (PR을 develop에 merge 시) [merge] #이슈번호 - 작업 내용 간략히 ``` ## 🐾 Git Flow + **Default Branch & PR Target : `develop`** From 0cd395410855393e9a52b8f87857531ef826746b Mon Sep 17 00:00:00 2001 From: Soomin Kim Date: Wed, 4 Mar 2026 10:24:16 +0900 Subject: [PATCH 2/2] =?UTF-8?q?[docs]=20README=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 83ba158..3bcf3c1 100644 --- a/README.md +++ b/README.md @@ -207,6 +207,7 @@ + - **Message** ```