DDD 출석은 DDD IT 동아리의 출석 관리를 효율적으로 도와주는 iOS 애플리케이션입니다. 간단하고 직관적한 인터페이스로 동아리원들의 출석 현황을 관리하고, 동아리 활동을 체계화할 수 있도록 지원합니다.
💡 우리는 왜 이 앱을 만들었을까요? DDD IT 동아리의 출석 관리를 위한 번거로운 과정을 줄이고, 개발자들이 학습과 네트워킹에 더 집중할 수 있는 환경을 만들고자 합니다.
프로젝트 규칙은 AGENTS.md에 정의되어 있습니다. Claude Code 사용 시 심볼릭 링크를 연결하세요.
ln -s AGENTS.md CLAUDE.md| 메인 화면 | 로그인 | 출석 관리 |
|---|---|---|
 |
 |
 |
| 출석 멤버 | 프로필 | 일정 |
|---|---|---|
 |
 |
 |
- Google OAuth 2.0: 간단한 구글 계정 로그인
- 자동 로그인 유지: 재실행 시 자동 인증 상태 유지
- 보안 강화: OAuth 2.0 기반 안전한 인증 시스템
- 실시간 출석 체크: 빠르고 정확한 출석 확인
- 출석 상태 관리: 출석, 지각, 결석, 대기 상태 구분
- 출석 이력 조회: 개인별 출석 현황 및 통계
- 출석률 통계: 시각적 통계 정보 제공
- 스터디 멤버 목록: 전체 참가자 현황 확인
- 멤버 상태 조회: 각 멤버의 출석 패턴 분석
- 관리자 권한: 스터디 운영진을 위한 관리 기능
- 직관적 UI/UX: 간단하고 명확한 인터페이스
- 실시간 동기화: 서버와의 실시간 데이터 동기화
- 오프라인 지원: 네트워크 없이도 기본 기능 사용 가능
- 다크 모드: 시스템 설정에 따른 다크/라이트 모드 지원
DDD-Attendance-iOS/
├── 📱 Projects/
│ ├── App/ # 메인 애플리케이션 타겟
│ │ ├── Sources/
│ │ │ ├── Application/ # AppDelegate, SceneDelegate
│ │ │ ├── Di/ # Dependency Injection
│ │ │ ├── Reducer/ # TCA Root Reducer
│ │ │ └── View/ # Root Views
│ │ ├── Resources/ # Assets, Fonts, Localizations
│ │ └── Tests/ # App 레벨 테스트
│ │
│ ├── Presentation/ # 🎨 UI Layer
│ │ ├── Auth/ # 로그인/인증 화면
│ │ ├── Splash/ # 스플래시 화면
│ │ ├── OnBoarding/ # 온보딩 화면
│ │ ├── Management/ # 출석 관리 화면
│ │ ├── Member/ # 멤버 관리 화면
│ │ ├── Profile/ # 프로필 화면
│ │ ├── Web/ # 웹뷰 화면
│ │ └── Presentation/ # 공통 프레젠테이션 유틸
│ │
│ ├── Domain/ # 🔥 Business Logic Layer
│ │ ├── Entity/ # 도메인 엔티티
│ │ ├── UseCase/ # 비즈니스 로직 구현
│ │ └── RepositoryInterface/ # Repository 프로토콜
│ │
│ ├── Data/ # 📡 Data Layer
│ │ ├── Repository/ # Repository 구현체
│ │ ├── DataSource/ # 로컬/원격 데이터소스
│ │ └── Model/ # DTO, Response Models
│ │
│ ├── Network/ # 🌐 Network Layer
│ │ ├── Foundation/ # 네트워크 기반 설정
│ │ ├── Service/ # API 서비스 구현
│ │ └── Configuration/ # 네트워크 설정
│ │
│ └── Shared/ # 🔧 Shared Layer
│ ├── DesignSystem/ # 디자인 시스템
│ ├── Utility/ # 공통 유틸리티
│ └── Extension/ # Swift Extensions
│
└── 🔧 Tuist/ # 프로젝트 설정
├── Package.swift
├── ProjectDescriptionHelpers/
└── Dependencies.swift
graph TD
A[🎨 Presentation Layer] --> B[🔥 Domain Layer]
B --> C[📡 Data Layer]
D[🌐 Network Layer] --> C
E[🔧 Shared Layer] --> A
E --> B
E --> C
A -.-> F[SwiftUI Views]
A -.-> G[TCA Reducers]
B -.-> H[Use Cases]
B -.-> I[Entities]
C -.-> J[Repositories]
C -.-> K[API Services]
프로젝트 모듈 간 의존성 관계도 (자동 생성)
Presentation → Domain (UseCase Protocol)
↓
Domain/UseCase → Domain (Repository Protocol)
↓
Data/Repository → Domain (Entity + Repository Protocol)
↓
Network/Service → Data (API 통신)
핵심 설계 원칙:
- ✅ Presentation은 Domain의 UseCase만 의존
- ✅ Domain은 외부 계층에 의존하지 않는 순수 비즈니스 로직
- ✅ Data는 Domain의 Entity와 Repository Protocol을 구현
- ✅ 모든 데이터 흐름은 Domain을 중심으로 진행
프로젝트의 상세한 개발 가이드라인은 docs/ 폴더의 문서들을 참고하세요:
- TCA 패턴 가이드 - TCA 기본 구조, Extension 패턴, Action 처리
- SwiftUI 스타일 가이드 - View 구조화, Extension 패턴, @ViewBuilder 활용
- 의존성 주입 (DI) - WeaveDI 3.4.1 패턴, AppDIManager
- TCAFlow 네비게이션 - @FlowCoordinator, 화면 전환, 딥 링크
- 팝업 & 모달 시스템 - CustomAlert, Toast, Modal 구현
- Swift 코딩 규칙 - Swift 스타일, 에러 처리, 테스트 패턴
- iOS 성능 최적화 - 서브에이전트 호출, 빌드 오류 해결
💡 참고: 이 가이드 문서들은 AI 에이전트들도 참조하여 프로젝트의 일관성 있는 코드 품질을 유지합니다.
- 🎯 Architecture: The Composable Architecture (TCA) 1.25.5
- 📦 Modularization: Tuist 4.x (Micro Feature Architecture)
- 💉 Dependency Injection: WeaveDI 3.4.0
- 🔀 Navigation: TCAFlow 1.1.0 (커스텀 라이브러리)
- ⚡ Concurrency: Swift Concurrency (async/await)
- ComposableArchitecture 1.25.5 - 단방향 데이터 플로우 및 상태 관리
- TCAFlow 1.1.0 ⭐️ - TCA 기반 화면 전환 및 네비게이션 (커스텀)
- WeaveDI 3.4.0 ⭐️ - 의존성 주입 컨테이너 (커스텀 포크)
- GoogleSignIn-iOS 9.0.0 - Google OAuth 2.0 인증
- AppAuth-iOS 2.0.0 - OAuth 2.0 및 OpenID Connect 클라이언트
- AsyncMoya 1.1.8 ⭐️ - async/await 기반 HTTP 클라이언트 (커스텀)
- SwiftUIX 0.2.3 - SwiftUI 확장 컴포넌트
- SDWebImageSwiftUI 2.0.0 - 비동기 이미지 로딩 및 캐싱
- Firebase iOS SDK 12.7.0 - Analytics, Crashlytics, Remote Config
- LogMacro: 커스텀 로깅 매크로
- IssueReporting: 개발 단계 이슈 추적
- XCTestDynamicOverlay: 테스트 환경 오버레이
- Clocks: 시간 관련 유틸리티
- ConcurrencyExtras: Swift Concurrency 확장
- Swift 6.0: 최신 Swift 언어 기능
- Tuist: 프로젝트 생성 및 의존성 관리
- Swift Package Manager (SPM): 패키지 의존성 관리
- fastlane: 자동화된 빌드 및 배포
- 💻 Xcode: 16.0 이상
- 📱 iOS: 17.0 이상
- ⚡ Swift: 6.0 이상
- 🔧 Tuist: 4.x 이상
- 💻 Xcode: 16.0 이상
- 📱 iOS: 17.0 이상
- ⚡ Swift: 6.0 이상
- 🔧 Tuist: 4.x 이상
git clone https://github.com/DDD-Community/Attendance_iOS.git
cd Attendance_iOScurl -Ls https://install.tuist.io | bash# 전체 워크플로우 (권장)
./make build # clean → install → generate
# 또는 단계별 실행
./make clean # 기존 파일 정리
./make install # 의존성 설치
./make generate # 프로젝트 생성open DDDAttendance.xcworkspace프로젝트 실행을 위해 다음 설정이 필요합니다:
// Config 파일에서 설정 (Dev.xcconfig, Prod.xcconfig)
BASE_URL = api.dddstudy.kr/
GOOGLE_CLIENT_ID = YOUR_GOOGLE_CLIENT_ID
GOOGLE_IOS_CLIENT_ID = YOUR_GOOGLE_IOS_CLIENT_ID
REVERSED_CLIENT_ID = YOUR_REVERSED_CLIENT_ID./make build # 전체 빌드 프로세스 (권장)
./make generate # 프로젝트 생성만
./make clean # 빌드 아티팩트 정리
./make install # 의존성 설치tuist clean # Tuist 캐시 정리
./make clean # 모든 빌드 파일 정리tuist graph # 의존성 그래프 생성
tuist test # 전체 테스트 실행fastlane ios beta # TestFlight 배포
fastlane ios release # App Store 배포
fastlane ios screenshots # 스크린샷 자동 생성
fastlane ios build_for_testing # 테스트 빌드fastlane 주요 기능:
- 자동화된 빌드 및 배포
- App Store Connect 관리
- 인증서 및 프로필 관리
- 스크린샷 자동 생성
- 앱 다운로드 및 설치
- Google 계정으로 로그인
- 권한 설정 (푸시 알림 등)
- 출석 탭에서 현재 스터디 세션 확인
- 출석 체크 버튼 터치
- 출석 상태 자동 업데이트 (출석/지각/결석/대기)
- 통계 탭에서 개인 출석률 확인
- 달력 뷰로 월별 출석 패턴 확인
- 상세 이력 조회 가능
- 프로필 탭에서 개인 정보 확인
- 설정 메뉴에서 앱 환경 설정
- 로그아웃 및 계정 관리
이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참고하세요.
- iOS Lead Developer: 서원지 (@Roy-wonji)
- iOS Developer: 홍은표 (@honghoker)
-
iOS:
-
Server:
-
Design:
-
VCS:
- Main Branch: 프로덕션 배포용
- Develop Branch: 개발 통합 브랜치
- Feature Branch: 기능별 개발 브랜치
- Develop 브랜치에서 Feature 브랜치 생성
- Feature 브랜치에서 개발 진행
- Feature → Develop Pull Request
- 코드 리뷰 및 충돌 해결 후 머지
- Develop → Main 배포용 Pull Request
- 📧 이메일: suhwj81@gmail.com
- 🐛 버그 신고: Issues
- 💡 기능 제안: Discussions
- 📱 App Store: DDD 출석 다운로드
Made with ❤️ by DDD Team
