DevLog

개발 기록과 Todo를 한 곳에서 관리하는 SwiftUI 기반 앱
저장한 링크, 작업 메모, 마감 일정, 개인 활동 흐름을 하나의 앱 안에서 정리하는 구조

홈	마크다운 작성	오늘 기준 Todo 확인	푸시 알림	히트맵

앱 사용해보기

iOS 17 이상 환경에서 App Store에서 다운로드 가능

프로젝트 개요

개발 과정에서 해야 할 일, 참고 링크, 진행 기록이 여러 곳에 흩어지기 쉬운 문제 해결 목적
Todo, 저장 링크, 오늘 할 일, 받은 알림, 누적 활동을 하나의 화면 흐름 안에서 함께 관리할 수 있도록 구성한 앱

• Todo 유형별 정리 및 빠른 탐색
• Markdown, 태그, 마감일, 중요 표시를 포함한 Todo 작성
• 웹 페이지 저장 및 재열람
• 오늘 기준 우선 확인 Todo 요약
• 받은 푸시 알림 확인 및 Todo 연계
• 분기별 활동 히트맵 제공
• Google, GitHub, Apple 로그인 및 계정 연동

아키텍처

MVVM을 기반으로 하되, ViewModel 상태 관리에는 MVI 형태의 단방향 흐름을 차용한 구조
DevLog.xcworkspace 안에서 Application, Widget 모듈을 분리하고 화면, 상태, 비즈니스 로직, 외부 의존성 경계를 나눈 MVVM + Clean Architecture 기반 구성

앱 아키텍처

Store 프로토콜

위젯 데이터 아키텍처

주요 기능

로그인 및 계정 관리

• Google, GitHub, Apple 로그인 지원
• 설정 화면에서 계정 연동 및 해제 관리
• 앱 내부 로그아웃 및 회원 탈퇴 흐름 제공
• Firebase Authentication 기반 사용자 세션 관리

Home

• 작업 성격별 Todo 유형 진입점 제공
• Home에서 Todo 유형 노출 여부 및 순서 편집
• 최근 수정 Todo 별도 섹션 제공
• 저장한 웹 페이지 목록 확인 및 즉시 열람
• URL 입력 시 메타데이터 수집 후 제목과 썸네일 저장

Todo 관리

• 8개 Todo 유형별 목록, 정렬, 완료 상태, 중요 표시 필터 지원
• Todo 목록 내 검색과 페이지네이션 기반 로드
• 스와이프 액션을 통한 중요 표시, 완료 처리, 삭제 지원
• Markdown, 태그, 마감일, 중요 표시 기반 Todo 작성 및 수정
• 상세 화면에서 생성일, 완료일, 마감일, 태그 확인

Today

• 남은 일, 집중 Todo, 지연 Todo, 7일 내 마감 Todo 요약 카드 제공
• 집중할 일, 지난 마감, 나중 일정, 일정 미정 등 기한 기준 섹션 분류
• 보기 범위와 중요 표시 조건 기반 빠른 필터링
• 항목별 스와이프 액션을 통한 중요 표시 및 완료 처리

알림

• 받은 푸시 알림 목록 확인
• 정렬, 기간, 읽지 않음 기준 필터링
• 알림 선택 시 연결된 Todo 상세 확인 및 읽음 처리
• 페이지네이션 및 실시간 동기화 기반 알림 목록 갱신
• 사용자 설정 시각 기준으로 다음 날 마감 Todo 리마인드 푸시 발송

검색

• Home 화면 검색 버튼을 통한 통합 검색 진입
• Todo와 저장한 웹 페이지 통합 검색
• 디바운스 기반 검색 처리
• 최근 검색어 저장, 개별 삭제, 전체 삭제 지원

프로필 및 설정

• 상태 메시지 직접 수정
• 분기 이동 및 직접 선택, 생성/완료 활동 필터 기반 히트맵 제공
• 테마 변경, 푸시 알림 시간 설정, 캐시 정리 기능 제공
• 설정 화면에서 앱 버전, 개인정보 처리방침, 베타 테스트 링크 확인

---

기술 스택

구분	스택
Deployment Target	iOS 17+
Architecture	Modular Architecture, MVVM, MVI-inspired state flow, Clean Architecture
UI	SwiftUI, Charts, MarkdownUI
State & Async	Observable, Combine, async/await
Backend	FirebaseAuth, FirebaseFirestore, Firebase Cloud Functions, FirebaseMessaging
Apple Frameworks	AuthenticationServices, UserNotifications, LinkPresentation, Network
Utility	GoogleSignIn, OrderedCollections
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.3
iOS Deployment Target	17.0
Swift	5.0
Tuist	4.194.4
Ruby	3.2
Fastlane	2.232.2
Node.js	22
TypeScript	4.9.5

1. 도구 설치

brew install mise
mise install

2. 비공개 설정 파일 준비

앱 실행에 필요한 비공개 설정 파일은 리포지토리에 포함되지 않음

Application/DevLogApp/Sources/Resource/
├── Config.xcconfig
└── GoogleService-Info.plist

3. Xcode 워크스페이스 생성

mise exec -- tuist generate --no-open

4. 빌드 확인

• Xcode에서 DevLog.xcworkspace 열기
• DevLogApp 스킴 선택
• iOS Simulator 선택 후 Build 실행

Project.swift, Workspace.swift, Tuist/ProjectDescriptionHelpers를 수정한 경우 다시 워크스페이스 생성 명령 실행.

프로젝트 구조

SwiftUI_DevLog/
├── 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
├── Widget/
│	├── DevLogWidgetCore/      # 위젯 스냅샷 모델, Factory, App Group 상수
│	└── DevLogWidgetExtension/ # WidgetKit UI, Provider, Timeline
├── Firebase/
│	└── functions/            # 인증 보조, 푸시 발송, 정리 작업용 Cloud Functions
├── docs/                     # README 이미지와 draw.io 원본
└── README.md