주인장 iOS - 부동산 매물 기록

주인장은 부동산 임장 정보를 사진, 음성, 체크리스트 등으로 손쉽게 기록하고 관리할 수 있는 앱입니다. 임장 점수 비교와 기록 공유 기능을 통해 개인 메모를 넘어 임장 정보를 함께 나누는 커뮤니티를 제공합니다.

💡 주인장에서 임장이란?

집을 직접 보러 가서 사진 찍고, 상태 체크하고, 비교·기록하는 활동

📢 2.0 버전 출시 (2025.08) — 대규모 UI 개편과 신규 기능 추가
👉 App Store에서 바로 보기

주인장 TEAM

iOS 2명

김동우	조유진
ornwoo96	yuzzin0121

Server 3명

Design 2명

PM 2명

주요 기능

임장 페이지 생성	사진, 녹음, 메모 추가	맞춤형 체크리스트 작성

임장 정보 커뮤니티	공유된 임장 정보 상세보기	나의 임장 정보 공유

개발 환경

• Swift 5.0
• iOS 16.0 +
• Xcode 16.0.0

사용 기술 및 라이브러리

• UIKit SnapKit Then
• ReactorKit RxSwift
• Alamofire Firebase
• Realm
• Tuist

폴더 구조

📂 Project
├── 📂 juinjang : 주인장 메인 모듈
│   └── 📂 Project
│       ├── 📂 Application : AppDelegate, SceneDelegate 등 앱 생명주기 관리
│       ├── 📂 Common : 공통으로 사용하는 Enum, Extensions, Protocol
│       ├── 📂 Components : 재사용 가능한 View 컴포넌트 모음
│       ├── 📂 Manager : 인앱결제, 녹음·재생, Firebase 연동 등 주요 서비스 로직 관리
│       ├── 📂 Model : Request/Response 구조체 (Decodable, Encodable)
│       ├── 📂 Network : 네트워크 관련 클래스 (BaseURL, APIManager, NetworkMonitor, TargetType 등)
│       ├── 📂 Repository : 레포지토리 패턴 기반 데이터 접근 계층
│       ├── 📂 Storage : 로컬 데이터 저장소 (UserDefaultsManager 등)
│       └── 📂 UserInterface : UI Scene 모음
│           ├── 📂 View : ViewController, 메인 뷰, 서브뷰 관리
│           └── 📂 Reactor : ReactorKit에서 사용하는 Reactor 클래스
└── 📂 Core : 프로젝트 전반에서 공통적으로 사용되는 핵심 유틸리티와 서비스 로직을 모아둔 모듈
    └── 📂 Project
        └── 📂 Common
            └── 📂 AnalyticsManager
                ├── AnalyticsEvent : 앱 내 주요 이벤트를 정의한 열거형/구조체. 화면 이동, 버튼 클릭, 기능 사용 등 분석 대상 이벤트의 식별자와 속성을 관리
                └── AnalyticsManager : Firebase Analytics, Amplitude 등 외부 분석 도구와의 연동을 담당. 이벤트 로깅, 사용자 속성 설정, 세션 추적 등의 기능 제공

아키텍처

현재 Tuist를 활용하여 모듈을 나누고 있으며, 초기에는 Main과 Core 2개 모듈로 구성했습니다. 추후 총 6개(App, Data, Domain, Presentation, Core, DesignSystem) 모듈로 확장할 예정이며, 이는 클린 아키텍처 원칙을 적용하기 위함입니다.

클린 아키텍처 도입 이유

• 관심사 분리 : UI, 비즈니스 로직, 데이터 접근 계층을 명확히 분리하여 유지보수성을 높임
• 의존성 방향 통제 : 핵심 도메인 로직이 외부 프레임워크나 UI 계층에 의존하지 않도록 설계
• 테스트 용이성 : 모듈별 단위 테스트와 독립적인 변경 검증이 가능
• 확장성 확보 : 기능 추가·변경 시 영향을 최소화하여 장기적으로 안정적인 프로젝트 운영 가능

ReactorKit 도입 이유

• 현재 앱 구조는 ReactorKit을 중심으로 개편
• 채택 이유는 앱 내 State 관리의 단순성과 낮은 러닝 커브

TCA 마이그레이션

• 다만, ReactorKit의 오래된 업데이트 중단으로 인해 Swift 최신 버전 대응과 SwiftUI 도입을 고려해, TCA(The Composable Architecture) 로의 전면 마이그레이션을 계획 중
• TCA는 SwiftUI와의 높은 호환성과 일관된 상태 관리 패턴을 제공해, 장기 유지보수에 유리하다고 판단

🔗 App Store

WiKi 바로가기

주인장 위키

☝️ 이 외에 궁금한점(주인장 컨벤션, Swift Style Guide)이 있다면 클릭해주세요.

🔗 추가 링크

• 공식 홈페이지
• 팀 개발 블로그
• 인스타그램
• Threads