depromeet / pumping-ios Goto Github PK

View Code? Open in Web Editor NEW

86.0 1.0 3.0 34.51 MB

Micro Feature Architecture Best Practice

Swift 99.95% Makefile 0.05%

swiftui thecomposablearchitecture tuist microfeature

pumping-ios's Introduction

Pumping

🔗 해당 주제로 포스팅한 글 모음

Micro Feature Architecture

Micro Feature Architecture은 백엔드의 Micro Service(Martinfowler 공식문서)의 개념으로부터 유래되었습니다. Tuist 공식문서에서 개괄적인 개념을 확인할 수 있습니다.

개요

"어라 그거 백엔드 개념 아니야 ?"
"겨우 사이드에서 그딴게 왜 필요해 ?"

저희 팀은 대규모 서비스를 위한 Micro Feature Architecture을 구성하였습니다. 굳이 할 필요 없는 작업이라고 생각이 들 수 있습니다. 당시에 참고할 만한 샘플이 존재하지 않았고 저희는 샘플앱이 되고자 했고, 노력의 과정을 기록하고자 합니다. 앞으로 리펙토링을 할지 말지는 결정된 사항이 없습니다. 누군가 이 샘플을 통해서 계속해서 발전시켜 나갔으면 합니다.

이상입니다 -

Tuist로 Micro Architecture 적용하기 저희가 작성한 블로그에서 자세한 내용을 모두 확인할 수 있습니다.

4 Layer

계층 구조는 다음과 같습니다.

Feature: 기능
Domain: 모델
Core: 템플릿
Shared: 공용 모듈

Target Type

타겟 타입은 다음과 같습니다.

Example: 샘플 앱
Implement: 구현부
Tests: 테스트
Testing: 테스트를 위한 목업
Interface: 인터페이스

Dependencies Graph

디펜던시 그래프는 다음과 같습니다.

Tech

Watch OS

watch OS 개발을 위해 사용된 라이브러리는 다음과 같습니다.

Dependency

Library Description

SwiftUI UI 작성

HealthKit 건강 데이터 접근

WatchConnectivity WachOS와 iOS 간 통신

The Composable Architecture (TCA) 아키텍쳐 적용

Library	Description
SwiftUI	UI 작성
HealthKit	건강 데이터 접근
WatchConnectivity	WachOS와 iOS 간 통신
The Composable Architecture (TCA)	아키텍쳐 적용

HealthKit

iOS의 건강 데이터를 담은 HealthKit 라이브러리에서, 기획 단에서 사용가능한 모든 데이터를 정리한 글을 작성하였습니다.

HealthKit에서 사용 가능한 모든 데이터 정리 저희가 작성한 블로그에서 자세한 내용을 모두 확인할 수 있습니다.

pumping-ios's People

Contributors

Stargazers

Watchers

Forkers

mooyoung2309 timelery derrickkim0109

pumping-ios's Issues

[feat] Profile 변화폭 UI

👀 Issue

✅ Todo

[feat] Root View 구현

👀 Issue

Root View를 구성합니다.

View를 라우팅 해야합니다.
하위 Feature에서 쓰이는 공통으로 쓰이는 View들의 관리를 고민합니다.
Reducer의 body를 분리할 방법을 고민합니다.

✅ Todo

[feat] KeyChainStore 구축

👀 Issue

토큰 및 유저정보를 저장할 키체인 스토어를 구축

✅ Todo

[feat] 초기 프로젝트 설정

[feat] Watch Connectivity

✅ Todo

watchOS와 iOS 앱 연동 데모 앱

앱 종료해도 실시간으로 트래킹 되는지
iOS 앱에서 watch앱의 시작 종료가 가능한지

[discussion] 6월 6일 오프라인 회의 정리

논의사항

결정된 사항을 정리합니다.

Folder 네이밍 한 뎁스 낮추는 것으로 결정

Tuist로 패키지 및 폴더를 강제하므로, 폴더 이름에서 중복을 제거하는 것으로 합니다.

Feature/FeatureOnboarding/FeatureOnboardingHome
->
Feature/Onboarding/Home

View는 인터페이스로 결정

오래된 이슈였는데, 결국 View와 Store가 모두 Interface에 있어야 View 타입을 재사용할 수 있다는 결정이 있었습니다.
아래의 이슈를 해결하고자 하기 위함입니다. 같은 레이어의 모듈간 Implements를 서로 몰라야하고 Interface로만 소통해야 함입니다.

또한 store의 구현부를 빼낸 것처럼 할수 있었지만, 그럴 필요가 없다는 결론을 내렸습니다. View는 껍데기일 뿐이고, Store가 핵심 비즈니스 로직을 담당하기 때문에 이부분만 빼내면 된다는 판단입니다.

즉 FeatureHome과 FeatureProfile은 Interface로 소통하고, Feature에서 FeatureHome과 FeatureProfile을 컴포지션 합니다.

// FeatureHome에서 FeatureProfile이 필요한 상항에서 다음과 같이 해결합니다.
// Feature
import FeatureProfile
import FeatureProfileInterface
import FeatureHome
import FeatureHomeInterface

let makeOtherProfileView: (...)  -> OtherProfileView = { ... in
    return OtherProfileView(store: ...)
}

HomeRootView(..., makeOtherProfileView: makeOtherProfileView)

// FeatureHome
struct HomeRootView: View {
     let makeOtherProfileView: (...) -> OtherProfileView

     public init(..., makeOtherProfileView:  @escaping (...) -> OtherProfileView) {
          ...
          self.makeOtherProfileView = makeOtherProfileView
    }
}

Cell을 DesignSystem에 포함되고, Store와 View를 한쌍(또는 많이)로 갖는 것으로 결정

Cell은 재사용을 위한 struct임이 분명하고, CellView와 CellStore로 나누어서 파일을 관리합니다. Cell이 상태를 갖게 설계하는 것을 피하며, 반드시 부모에게 내려받는 상태로 관리하는 것으로 하는 것을 강제합니다.

DesignSystem의 Components에 해당하는 View는 Store를 갖지 않는 것으로 결정

Button, TextField 등 으로 사용되는 공통 컴포넌트는 Binding 키워드를 통해 관리합니다.

물론 상태는 부모에서 관리합니다.

[feat] Sample WatchApp 구현

✅ Todo

[feat] Chat GPT Code Review Workflow 추가

👀 Issue

https://github.com/anc95/ChatGPT-CodeReview

✅ Todo

[feat] 운동 Start UI 구현

👀 Issue

✅ Todo

[feat] swift lint 설정

👀 Issue

✅ Todo

[feat] 운동 Timer UI 구현

👀 Issue

✅ Todo

[feat] Signing 적용

👀 Issue

✅ Todo

[feat] Profile View 재구성

👀 Issue

중복되는 UI 한 타겟으로 재구성해야한다.

✅ Todo

[feat] 운동 Root UI 구현

👀 Issue

✅ Todo

[feat] Tuist plugin으로 모듈화 관리

👀 Issue

✅ Todo

[feat] Apple Login 기능 추가

👀 Issue

✅ Todo

[feat] 프로필 화면 구성

👀 Issue

✅ Todo

[feat] 타겟 모듈화

👀 Issue

✅ Todo

[feat] Network Module 구현

👀 Issue

Core Layer의 Network 모듈을 구현

✅ Todo

[feat] 운동 End UI 구현

👀 Issue

✅ Todo

[feat] 앱 이름을 pumping 으로 변경

👀 Issue

✅ Todo

Signing
Workspace & Project Name 변경

[feat] 운동중 디테일 UI 수정

👀 Issue

✅ Todo

[feat] 운동중 디테일 UI 수정

👀 Issue

✅ Todo

[feat] WatchApp 모듈 분리

👀 Issue

✅ Todo

[feat] Apple Login Domain 구성

👀 Issue

✅ Todo

[feat] Ranking UI 구현

👀 Issue

✅ Todo

[feat] Crew 생성View

👀 Issue

✅ Todo

[feat] airbnb swift 라이브러리 추가

👀 Issue

✅ Todo

[feat] Workout Home View 디테일 수정

👀 Issue

✅ Todo

[feat] HealkitManager

✅ Todo

[feat] 프로필 뷰 생성

👀 Issue

✅ Todo

[feat] App, Domain, Feature, Core 모듈화

👀 Issue

프로젝트 구성을 위해서, 샘플코드를 추가하여서 전체 학습을 돕는 목적입니다.
아직 기획전이긴 하지만, 최대한 예측해서 작성해보면 좋을 것 같습니다.

✅ Todo

[feat] static framework에서 dynamic framwork로 변경

👀 Issue

static framework
- (복사) do not embed 방식
- 컴파일 타임에서 로드 시킴
- 단점: 앱의 사이즈가 증가 (바이너리 파일이 포함되어야 하기 때문)
- 장점: 빠르다
dynamic framework(framwork 디폴트 값 임)
- (참조) embed 방식
- 런타임에서 필요시 로드 시킴 (lazy 한 작동 방식)
- 단점: 느리다
- 장점: 앱의 사이즈 늘지 않음 (바이너리에 미포함, 런타임 시점에서 로드 시키기 때문), 재사용시 참조 방식이어서 중복이 발생하지 않음