개발 기록과 Todo를 한 곳에서 관리하는 SwiftUI 기반 앱
저장한 링크, 작업 메모, 마감 일정, 개인 활동 흐름을 하나의 앱 안에서 정리하는 구조
|
|
|
|
|
| 홈 | 마크다운 작성 | 오늘 기준 Todo 확인 | 푸시 알림 | 히트맵 |
개발 과정에서 해야 할 일, 참고 링크, 진행 기록이 여러 곳에 흩어지기 쉬운 문제 해결 목적
Todo, 저장 링크, 오늘 할 일, 받은 알림, 누적 활동을 하나의 화면 흐름 안에서 함께 관리할 수 있도록 구성한 앱
- Todo 유형별 정리 및 빠른 탐색
- Markdown, 태그, 마감일, 중요 표시를 포함한 Todo 작성
- 웹 페이지 저장 및 재열람
- 오늘 기준 우선 확인 Todo 요약
- 받은 푸시 알림 확인 및 Todo 연계
- 분기별 활동 히트맵 제공
- Google, GitHub, Apple 로그인 및 계정 연동
DevLog.xcworkspace 안에서 Application, Widget 모듈을 분리하고 화면, 상태, 비즈니스 로직, 외부 의존성 경계를 나눈 Clean Architecture 기반 구성
|
| Tuist 모듈 의존성 그래프 |
- Google, GitHub, Apple 로그인 지원
- 설정 화면에서 계정 연동 및 해제 관리
- 앱 내부 로그아웃 및 회원 탈퇴 흐름 제공
- Firebase Authentication 기반 사용자 세션 관리
- 작업 성격별 Todo 유형 진입점 제공
- Home에서 Todo 유형 노출 여부 및 순서 편집
- 최근 수정 Todo 별도 섹션 제공
- 저장한 웹 페이지 목록 확인 및 즉시 열람
- URL 입력 시 메타데이터 수집 후 제목과 썸네일 저장
- 8개 Todo 유형별 목록, 정렬, 완료 상태, 중요 표시 필터 지원
- Todo 목록 내 검색과 페이지네이션 기반 로드
- 스와이프 액션을 통한 중요 표시, 완료 처리, 삭제 지원
- Markdown, 태그, 마감일, 중요 표시 기반 Todo 작성 및 수정
- 상세 화면에서 생성일, 완료일, 마감일, 태그 확인
- 남은 일, 집중 Todo, 지연 Todo, 7일 내 마감 Todo 요약 카드 제공
- 집중할 일, 지난 마감, 나중 일정, 일정 미정 등 기한 기준 섹션 분류
- 보기 범위와 중요 표시 조건 기반 빠른 필터링
- 항목별 스와이프 액션을 통한 중요 표시 및 완료 처리
- 받은 푸시 알림 목록 확인
- 정렬, 기간, 읽지 않음 기준 필터링
- 알림 선택 시 연결된 Todo 상세 확인 및 읽음 처리
- 페이지네이션 및 실시간 동기화 기반 알림 목록 갱신
- 사용자 설정 시각 기준으로 다음 날 마감 Todo 리마인드 푸시 발송
- Home 화면 검색 버튼을 통한 통합 검색 진입
- Todo와 저장한 웹 페이지 통합 검색
- 디바운스 기반 검색 처리
- 최근 검색어 저장, 개별 삭제, 전체 삭제 지원
- 상태 메시지 직접 수정
- 분기 이동 및 직접 선택, 생성/완료 활동 필터 기반 히트맵 제공
- 테마 변경, 푸시 알림 시간 설정, 캐시 정리 기능 제공
- 설정 화면에서 앱 버전, 개인정보 처리방침, 베타 테스트 링크 확인
| 구분 | 스택 |
|---|---|
| Deployment Target | iOS / iPadOS 17.0+ |
| Platform Support | iPhone, iPad, Apple Silicon Mac (App Store, Designed for iPad) |
| Architecture | Tuist Modular based Clean Architecture |
| UI | SwiftUI, MarkdownUI, WidgetKit, AppIntents |
| State & Async | Observable, Combine, async/await, The Composable Architecture |
| Backend | Firebase Authentication, Firestore, Cloud Functions, Cloud Messaging |
| Monitoring | Firebase Analytics, Crashlytics |
| Apple Frameworks | AuthenticationServices, UserNotifications, LinkPresentation, Network, CryptoKit, os.log |
| External Packages | ComposableArchitecture, MarkdownUI, OrderedCollections, GoogleSignIn, Nexa |
| Testing | swift-testing, TCA TestStore |
| Tooling | Xcode, Tuist, mise, Swift Package Manager, SwiftLint, Fastlane |
- Xcode 프로젝트와 워크스페이스는 Tuist manifest를 기준으로 생성하며 Git은 생성물을 추적하지 않음
.mise.toml에서 Tuist 버전을 고정Workspace.swift, 각 모듈의Project.swift,Tuist/ProjectDescriptionHelpers가 Xcode 프로젝트 생성 기준- Swift Package 의존성은 Tuist 생성 과정에서
.spm/아래로 resolve
| 항목 | 버전 |
|---|---|
| Xcode | 26.5 |
| iOS Deployment Target | 17.0 |
| Swift | 5.0 |
| Tuist | 4.194.4 |
| SwiftLint | 0.63.3 |
| Ruby | 3.4.7 |
| Bundler | 2.7.2 |
| Fastlane | 2.232.2 |
brew install mise
brew install swiftlint
mise install앱 실행에 필요한 비공개 설정 파일은 리포지토리에 포함되지 않음
Application/DevLogApp/Sources/Resource/
├── Config.xcconfig
└── GoogleService-Info.plist
Firestore database는 build configuration 기준으로 분리함
Debug, Staging -> staging
Release -> prod
TestFlight archive는 Staging, App Store 실제 서비스 archive는 Release configuration을 사용함
GitHub Actions 배포 workflow는 PR label 기반 자동 실행 없이 수동 실행함
TestFlight build는 App Store 심사 제출 대상으로 승격하지 않고, 실제 배포는 같은 MARKETING_VERSION의 별도 Release/prod build로 생성함
build number는 TestFlight와 App Store upload가 공유하는 App Store Connect build number 공간에서 자동 증가함
- TestFlight build:
bundle exec fastlane testflight_build_only - TestFlight upload:
bundle exec fastlane deploy_testflight - App Store build:
bundle exec fastlane appstore_build_only - App Store upload:
bundle exec fastlane deploy_appstore
mise exec -- tuist generate --no-open- Xcode에서
DevLog.xcworkspace열기 DevLogApp스킴 선택- iOS Simulator 선택 후 Build 실행
Project.swift, Workspace.swift, Tuist/ProjectDescriptionHelpers를 수정한 경우 다시 워크스페이스 생성 명령 실행.
DevLog_iOS/
├── Tuist.swift
├── Workspace.swift
├── .mise.toml
├── Tuist/
│ └── ProjectDescriptionHelpers/ # Tuist 공통 패키지, 설정, 타깃 템플릿
├── Application/
│ ├── DevLogApp/ # 앱 진입점, 앱 생명주기, 라우팅, Assembler 구성
│ ├── DevLogCore/ # DI, Logger, Query, 공통 값 타입
│ ├── DevLogDomain/ # Entity, Repository Protocol, UseCase
│ ├── DevLogData/ # Repository 구현, DTO, Mapper, Data 계층 Protocol
│ ├── DevLogInfra/ # Firebase, 소셜 로그인, 네트워크, 메타데이터 서비스 구현
│ ├── DevLogPersistence/ # UserDefaults, 이미지 저장소, 앱 로컬 영속성 처리
│ ├── DevLogPresentation/ # SwiftUI 화면, ViewModel, Store, Coordinator
│ └── DevLogWidget/ # 앱-위젯 브릿지, 위젯 동기화 이벤트, 스냅샷 갱신
├── Widget/
│ ├── DevLogWidgetCore/ # 위젯 스냅샷 모델, Factory, App Group 상수
│ └── DevLogWidgetExtension/ # WidgetKit UI, Provider, Timeline
├── docs/ # README 이미지와 draw.io 원본
└── README.md