웹소소 앱의 차세대 iOS 클라이언트 저장소입니다.
서비스 성장에 따라 빠르게 늘어나는 기능 요구사항에 대응하고,
안정적으로 기능을 확장할 수 있는 구조를 만들기 위해
Tuist 기반 멀티 모듈 + Clean Architecture 방향으로 재설계를 진행하고 있습니다.
| 구분 | 🚨 As-Is (V1) | ✨ To-Be (V2) |
|---|---|---|
| 프로젝트 구조 | 단일 Xcode 프로젝트 | Tuist 기반 멀티 모듈 |
| 의존성 방향 | 양방향 및 복잡한 의존성 존재 | 단방향 (UI -> Domain <- Data) |
| 비동기 처리 | RxSwift 중심 | Domain/Data는 Swift Concurrency, UI는 Combine 예정 |
| 기능 개발 | 영향 범위 파악이 어렵고 기능 간 결합도가 높음 | 도메인별 독립 개발과 점진적 기능 이전 가능 |
| 테스트/검증 | UI 구현 이후에야 검증 가능 | Domain 중심 테스트와 모듈 단위 검증 가능 |
| 개발 생산성 | 전체 프로젝트 빌드와 수작업 설정 중심 | 모듈 단위 빌드, 템플릿 기반 확장, Demo 검증 가능 |
WSS-iOS(V1)는 현재 운영 중인 클라이언트입니다.WSS-iOS-V2는 구조 개선과 점진적 기능 이전을 위한 차세대 코드베이스입니다.- 현재는 Core / Domain / Data 레이어 정비와 테스트 가능한 기반 구축을 우선하고 있습니다.
- 현재까지
Core 3개,Data 3개,Domain 12개모듈을 분리했고, Swift Testing과/domain-test기반 검증 흐름을 갖췄습니다.
웹소소는 서비스 운영과 함께 추천, 기록, 커뮤니티 기능이 빠르게 확장되었고, 그 과정에서 UI, 비즈니스 로직, 네트워크 구현, 외부 라이브러리 의존성이 여러 계층에 걸쳐 섞이기 시작했습니다. 이 구조에서는 작은 변경도 영향 범위를 예측하기 어려웠고, 기능 추가와 테스트 비용도 계속 커졌습니다.
V2는 이런 문제를 줄이기 위해 시작한 리빌드 프로젝트입니다. 핵심 목표는 비즈니스 로직을 Domain 계층으로 분리하고, Core / Domain / Data 레이어를 먼저 안정화한 뒤, 필요한 기능을 점진적으로 App에 연결해 유지보수와 확장에 강한 iOS 코드베이스를 만드는 것입니다.
현재는 Core / Domain / Data 레이어를 먼저 정리하고 있으며,
이후 Feature와 App 레이어를 연결해 실제 기능과 화면까지 포함하는 앱 구조로 확장해갈 계획입니다.
현재 V2는 기능을 한 번에 모두 옮기기보다, 기반 구조를 먼저 분리하고 검증 가능한 단위로 쪼개는 데 초점을 맞추고 있습니다.
Core는 Networking, Keychain, Logger처럼 재사용 가능한 기반 기술을 담당합니다.Domain은 Entity, UseCase, Repository 프로토콜 등 비즈니스 로직을 담당합니다.Data는 DTO, Mapper, Service, Repository 구현체를 통해 외부 데이터를 연결합니다.- 이후
Feature와App레이어를 연결해 실제 기능과 화면을 단계적으로 옮겨갈 계획입니다.
App
└── DI와 전역 흐름 조립
Feature
└── 실제 기능 구현(UI 포함)
Domain
└── 비즈니스 로직과 Repository 프로토콜
Data
└── Repository 구현
Core
└── 의존성을 최소화한 외부 기술 자체
App
├── WSS-iOS # SwiftUI 앱 진입점과 조립 대상
│
Core
├── Logger # 로깅 추상화와 콘솔 로거
├── Networking # 네트워크 클라이언트와 요청/응답 추상화
└── Keychain # 보안 저장소와 키체인 접근 래퍼
│
Domain
├── AuthDomain # 사용자 인증, 로그아웃, 탈퇴
├── BaseDomain # 공통 식별자, 평점, 장르, 에러 등 기본 타입
├── Comment # 댓글 작성, 수정, 삭제, 조회
├── Feed # 피드 작성/수정/삭제, 상세 조회, 좋아요
├── Keyword # 키워드 조회와 검색
├── NotificationDomain # 알림 조회와 푸시 설정
├── Novel # 작품 조회, 검색, 서재, 관심 등록
├── NovelReviewDomain # 리뷰 초안 조회, 저장, 삭제
├── Profile # 프로필, 닉네임, 선호 장르/작품 설정
├── Recommendation # 홈 추천, 소소픽, 트렌딩 피드
├── Setting # 앱 업데이트 정책과 약관 동의
└── SocialDomain # 차단 사용자 관리와 신고 기능
│
Data
├── NotificationData # 알림/푸시 API 연동과 Repository 구현
├── NovelReviewData # 리뷰 API 연동, DTO 매핑, Repository 구현
└── RecommendationData # 추천 데이터 연동 모듈
Tuist 템플릿으로 Core / Domain / Data / Feature 모듈 생성 방식을 통일했습니다. 핵심은 모듈 생성 규칙을 코드로 고정해, 새 기능이 추가되어도 같은 방식으로 확장되도록 만드는 것입니다.
public static func createDomainModule(
name: String,
targets: Set<TargetType>,
internalDependencies: [TargetDependency] = [],
externalDependencies: [TargetDependency] = []
) -> Project {
let allTargets = makeBaseTargets(
name: name,
product: .framework,
targets: targets,
sources: ["Sources/**"],
resources: nil,
internalDependencies: internalDependencies,
externalDependencies: externalDependencies,
demoDependencies: [],
testDependencies: [],
deploymentTarget: env.deploymentTarget,
infoPlist: ModuleInfoPlist.domain.infoPlist
)
...
}- 모듈 생성 방식이 일관돼 신규 기능 추가 시 구조가 흔들리지 않습니다.
- 테스트, Demo, Testing 타깃 구성을 같은 패턴으로 가져갈 수 있습니다.
- 프로젝트 설정을 수작업으로 반복하지 않아도 됩니다.
비즈니스 로직을 Domain에 두고, Data가 Repository를 구현하는 구조를 택했습니다. 이렇게 하면 UI 변경과 핵심 정책 변경의 영향을 분리하기 쉽고, 테스트에서도 Mock 주입이 단순해집니다.
public protocol NotificationRepository {
func loadNotifications(
lastNotificationID: NotificationID?,
size: Int
) async throws(RepositoryError) -> PagedNotifications
func loadNotificationDetail(
id: NotificationID
) async throws(RepositoryError) -> NotificationDetail
}Domain은 구현체를 모르고, 필요한 계약만 정의합니다. 이 덕분에 UI나 네트워크 방식이 바뀌어도 비즈니스 로직 자체는 유지할 수 있습니다.
현재 Domain / Data 모듈은 async/await 기반으로 작성하고 있으며,
UI 레이어는 상태 바인딩과 이벤트 처리를 위해 Combine을 사용하는 방향을 고려하고 있습니다.
public protocol NotificationRepository: Sendable {
func loadNotifications(lastNotificationID: NotificationID?, size: Int)
async throws(RepositoryError) -> PagedNotifications
}- Domain/Data는 요청-응답과 비즈니스 흐름을 직관적으로 표현하기 위해 Swift Concurrency를 사용합니다.
- UI는 상태 바인딩과 이벤트 조합이 중요하므로 Combine을 적용할 계획입니다.
- 계층마다 다른 요구에 맞는 비동기 모델을 선택해 과도한 추상화를 피하고자 했습니다.
Data 모듈은 Service → Repository → Mapper 구조로 나누어 작성하고 있습니다.
이 구조는 네트워크 호출, 도메인 매핑, 저장 책임을 분리해 변경 영향을 줄이는 데 목적이 있습니다.
public struct DefaultNotificationRepository: NotificationRepository {
private let service: NotificationService
private let logger: NotificationLogger?
public func loadNotifications(
lastNotificationID: NotificationID?,
size: Int
) async throws(RepositoryError) -> PagedNotifications {
do {
let query = NotificationQeury(
lastNotificationId: lastNotificationID?.value ?? 0,
size: size
)
let response = try await service.getNotifications(query)
return NotificationMapper.pagedNotifications(from: response)
} catch let error as NetworkingError {
logger?.logError(type: .network, action: .loadNotifications, error: error)
throw error.toRepositoryError()
} catch {
logger?.logError(type: .unknown, action: .loadNotifications, error: error)
throw .unknown
}
}
}이렇게 하면 Data 계층에서 네트워크 오류를 Domain의 RepositoryError로 변환하고,
로깅까지 함께 처리할 수 있어 Domain은 외부 구현 세부사항을 알 필요가 없습니다.
테스트는 Swift Testing 기반으로 작성되어 있으며, CI는 현재 Domain 스킴 병렬 테스트를 중심으로 검증 흐름을 운영하고 있습니다.
@Suite("DefaultNotificationRepository")
struct DefaultNotificationRepositoryTests {
@Test("알림 목록 조회 성공 시 PagedNotifications 반환")
func loadsNotificationsSuccessfully() async throws {
let service = MockNotificationService()
let logger = MockNotificationLogger()
service.getNotificationsResult = .success(makeNotificationsResponse())
let sut = makeRepository(service: service, logger: logger)
let result = try await sut.loadNotifications(lastNotificationID: nil, size: 10)
#expect(result == makePagedNotifications())
#expect(service.requestedQuery?.size == 10)
#expect(logger.loggedErrors.isEmpty)
}
}- Domain/Data 레이어는 UI 없이도 빠르게 검증할 수 있습니다.
- 테스트 더블을 통해 정책과 오류 매핑을 먼저 검증할 수 있습니다.
- 현재 CI도 이 모듈 단위 테스트 흐름에 맞춰 구성되어 있습니다.
 최서연 |
 이윤학 |
 이원선 |
Language: SwiftUI: SwiftUIMinimum Target: iOS 17.0Async: Domain/Data는 Swift Concurrency, UI는 CombineProject: TuistArchitecture: Clean Architecture 기반 멀티 모듈Test: Swift TestingCI/CD: GitHub ActionsDependencies: 없음
# Tuist 설치
mise install
# 의존성 설치 + 프로젝트 생성
tuist install
tuist generate- WSS-iOS (V1) — 기존 프로젝트
- 웹소소 공식 사이트
- App Store