MultiModuleTemplate

🏗️ 프로젝트 구조 (Clean Architecture)

MultiModuleTemplate/
├── Workspace.swift
├── Tuist.swift
├── Projects/
│ ├── App/ # 메인 애플리케이션
│ ├── Presentation/
│ │ └── Presentation/ # 화면 및 ViewModel 구성
│ ├── Domain/ # 🔥 도메인 계층 (비즈니스 로직 + Protocol)
│ │ ├── Entity/ # 도메인 엔티티 + Entity Protocol
│ │ ├── UseCase/ # 비즈니스 로직 + UseCase Protocol
│ │ ├── DomainInterface/ # Domain 계층 인터페이스 모듈
│ │ └── DataInterface/ # Data 계층 인터페이스 모듈
│ ├── Data/ # 데이터 계층 (데이터 접근 + Model)
│ │ ├── Model/ # 데이터 전송 객체 (DTO, API Response)
│ │ ├── Repository/ # Repository 구현체 (Domain Protocol 구현)
│ │ ├── API/ # REST API 클라이언트
│ │ └── Service/ # 데이터 처리 서비스
│ ├── Network/ # 네트워크 계층
│ │ ├── Networking/ # 네트워크 기본 설정 및 클라이언트
│ │ └── Foundations/ # 네트워크 기반 유틸리티
│ ├── Core/
│ │ ├── Core/ # 핵심 공통 모듈
│ │ └── ThirdParty/ # Core 레벨 외부 라이브러리
│ └── Shared/
│ ├── DesignSystem/ # 공통 UI 컴포넌트, 폰트 등
│ ├── Shared/ # 공통 공유 모듈
│ └── Utill/ # 공통 유틸리티
├── Tuist/
│ ├── Package.swift
│ └── ProjectDescriptionHelpers/
└── Plugins/

Tuist graph

🚀 빠른 시작

새 프로젝트 생성 (권장)

# 1. TuistTool 컴파일 (최초 1회만)
swiftc TuistTool.swift -o tuisttool
# 2. 새 프로젝트 생성 (대화형으로 이름 설정)
./tuisttool newproject

템플릿 그대로 사용

# Tuist 4.97.2 최신 명령어
tuist install # 의존성 설치 (새로운 명령어)
tuist generate # 프로젝트 생성
tuist build # 빌드
tuist test # 테스트
# 또는 TuistTool 사용 (권장)
./tuisttool build # clean + install + generate 한번에

주요 모듈 설명

📱 Application Layer

🏗 Domain Layer (비즈니스 로직 + Protocol)

📊 Data Layer (데이터 접근 + Model)

🌐 Network Layer

🎨 Shared Layer

🔄 의존성 방향 (Clean Architecture)

Presentation → Domain (UseCase Protocol)
 ↓
Domain/UseCase → Domain (Repository Protocol)
 ↓
Data/Repository → Domain (Entity + Repository Protocol)
 ↓
Data/Model → Domain (Entity 변환)

개발 환경

사용 라이브러리

⚡ Tuist 4.97.2 최적화

🚀 성능 최적화

🔍 새로운 분석 도구

📋 최신 API 사용

🏗 Clean Architecture 설계

🎯 Domain 중심 설계

📋 Domain Layer (Protocol + Entity + UseCase)

// Domain/Entity/User.swift
public struct User {
 public let id: String
 public let name: String
 public let email: String
 public init(id: String, name: String, email: String) {
 self.id = id
 self.name = name
 self.email = email
 }
 // 비즈니스 로직
 public var displayName: String {
 return name.isEmpty ? "Unknown User" : name
 }
}
// Domain/Repository/UserRepository.swift
public protocol UserRepository {
 func fetchUser(id: String) async throws -> User
 func saveUser(_ user: User) async throws
}
// Domain/UseCase/GetUserUseCase.swift
public protocol GetUserUseCase {
 func execute(id: String) async throws -> User
}
public final class GetUserUseCaseImpl: GetUserUseCase {
 private let repository: UserRepository
 public init(repository: UserRepository) {
 self.repository = repository
 }
 public func execute(id: String) async throws -> User {
 return try await repository.fetchUser(id: id)
 }
}

🏗️ Data Layer (Model + Repository 구현)

// Data/Model/UserModel.swift
import Domain
public struct UserModel: Codable {
 public let user_id: String
 public let user_name: String
 public let user_email: String
 // ✅ Model → Entity 변환 (Data가 Domain 의존)
 public func toEntity() -> User {
 return User(
 id: user_id,
 name: user_name,
 email: user_email
 )
 }
}
// Data/Repository/UserRepositoryImpl.swift
import Domain
public final class UserRepositoryImpl: UserRepository {
 private let apiService: APIService
 public init(apiService: APIService) {
 self.apiService = apiService
 }
 public func fetchUser(id: String) async throws -> User {
 let model: UserModel = try await apiService.fetchUser(id: id)
 return model.toEntity() // Model → Entity 변환
 }
}

💡 핵심 장점

1. Domain 중심 의존성

✅ Domain 통합 방식:
Presentation → Domain (Protocol + Entity)
 ↓
Data → Domain (Protocol 구현 + Entity 사용)
모든 계층이 Domain을 중심으로 의존

2. 응집도 향상

// 관련 Protocol과 구현이 같은 모듈에
// Domain/UseCase/GetUserUseCase.swift
public protocol GetUserUseCase {
 func execute(id: String) async throws -> User
}
public final class GetUserUseCaseImpl: GetUserUseCase {
 // 구현체도 같은 파일에
}

3. 테스트 용이성

// Mock 구현이 매우 간단
final class MockUserRepository: UserRepository {
 func fetchUser(id: String) async throws -> User {
 return User(id: "mock", name: "Mock User", email: "mock@test.com")
 }
}
// 테스트에서 쉽게 사용
let mockRepo = MockUserRepository()
let useCase = GetUserUseCaseImpl(repository: mockRepo)
let user = try await useCase.execute(id: "test")

4. 단순한 구조

🛠️ TuistTool (커스텀 CLI)

설치 및 사용법

# 컴파일
swiftc TuistTool.swift -o tuisttool
# 사용법
./tuisttool <command>

지원 명령어 요약

상세 동작

🚀 동적 프로젝트 이름 설정

사용 방법

🎯 방법 1: TuistTool 사용 (권장)

# 대화형 입력
./tuisttool newproject
# 명령어 인자로 바로 설정
./tuisttool newproject MyAwesomeApp --bundle-id com.company.app

🎯 방법 2: 환경변수 (CI/CD용)

export PROJECT_NAME="MyAwesomeApp"
export BUNDLE_ID_PREFIX="com.company.awesome"
tuist generate

🎯 방법 3: Tuist 템플릿 (완전히 새 프로젝트)

mkdir MyNewProject && cd MyNewProject
tuist scaffold multi-module-project --name MyNewProject

설정 가능한 항목

🎯 자주 쓰는 명령어

새 프로젝트 생성

# 대화형 생성 (권장)
./tuisttool newproject
# 명령어로 한번에 생성
./tuisttool newproject MyApp --bundle-id com.company.myapp --team-id ABC123

기본 개발 워크플로우

# Tuist 4.97.2 최적화된 워크플로우
./tuisttool build # clean → install → generate
./tuisttool test # 테스트 실행
# 코드 품질 검사
./tuisttool inspect-imports # 암시적 의존성 검사
./tuisttool inspect-coverage # 코드 커버리지 분석

문제 해결

# 강력한 클린 (모든 캐시 삭제)
./tuisttool reset
# 의존성 재설치
./tuisttool install
# 프로젝트 구조 분석
tuist graph --format pdf --path ./graph.pdf

모듈 개발

# 새 모듈 생성 (자동 의존성 설정)
./tuisttool moduleinit
# 특정 모듈만 포커스
tuist focus <모듈명>

🔧 CI/CD 예시

GitHub Actions (권장)

# CI 파이프라인
./tuisttool reset # 모든 캐시 클린
./tuisttool build # clean → install → generate
./tuisttool test # 테스트 실행
./tuisttool inspect-imports # 의존성 검증

로컬 재현

# CI와 동일한 환경에서 로컬 테스트
./tuisttool reset && ./tuisttool build && ./tuisttool test

기여 방법

라이선스