Home

UMC PRODUCT iOS Wiki

UMC(University MakeUs Challenge) 동아리 운영 관리 앱 — iOS 클라이언트 개발 위키

"Focus on Growth, We Handle the Ops"

디스코드·구글 시트·노션으로 흩어진 동아리 운영 도구를 하나의 앱으로 통합합니다. 이 위키는 코드를 읽기 전에 알아야 할 아키텍처·규칙·빌드 방법을 한곳에 모읍니다.

---

🚀 시작하기 (신규 합류자)

1. Build & Run — 환경 설정, 시크릿 수령, 첫 빌드
2. Architecture — 계층 구조와 데이터 흐름 이해
3. Coding Conventions — 절대 규칙 9개 + 코딩 스타일
4. Git Workflow — 브랜치·커밋·PR·이슈 규칙

📚 문서 목록

주제	설명
Architecture	Feature 기반 Clean Architecture, Observation, PathStore 라우팅
Coding Conventions	절대 규칙, 코딩 스타일, 네이밍 규칙
Error Handling	Loadable · ErrorHandler · AlertPrompt 선택 기준
Networking	Moya Router 설계, Response DTO 디코딩, STOMP 실시간
Design System	디자인 토큰, Typography, Glass, 성능 최적화
Module Structure	Tuist(UMCApp) 모듈 구조, 의존성 방향
Build & Run	빌드 명령, 시크릿 설정, 테스트, CI
Git Workflow	브랜치 전략, 커밋·PR·이슈·배포 규칙
Stella · API 커버리지	Moya Router ↔ OpenAPI 커버리지 추적 도구 (apicov CLI · stella GUI)
Team	기수별 iOS 팀원 소개 (사진·역할·GitHub)
Release History	기수별 신규 기능·운영 기록

🧭 한눈에 보기

버전

항목	값
최신 릴리즈 태그	v2.2.0 (레거시 AppProduct/ 기준, 동결)
개발 중 마케팅 버전	3.0.0 (Settings+Recommended.swift의 MARKETING_VERSION)
Deployment Target	iOS 26.4 (watchOS 26.4)

기술 스택

• 언어/UI: Swift 6.3 · SwiftUI (iOS 26 Liquid Glass) · Observation
• 빌드: Tuist 4.155.0 (mise로 버전 고정) · Makefile 진입점
• 네트워크: Moya 15 · STOMP over WebSocket (실시간 스레드)
• 인증: Kakao SDK · GoogleSignIn · Sign in with Apple · 이메일(ID/PW)
• Firebase: Messaging(FCM 푸시) · RemoteConfig(킬스위치·강제 업데이트)
• 로컬 저장: SwiftData
• 온디바이스 AI: FoundationModels (공지 요약 · 일정 파싱 · 스레드 요약/분류)
• 근거리: MultipeerConnectivity + NearbyInteraction (명함 교환)
• 확장 타겟: WidgetKit Extension · watchOS Companion App
• 이미지: Kingfisher 8

아키텍처

View ←→ ViewModel(@Observable) → UseCase(Protocol) → Repository → DataSource
                                    ↑  DIContainer가 Protocol 구현체 주입

두 빌드 축

• UMCApp/ (Tuist) — 모든 신규·유지보수 작업의 대상. Core 11개 + Feature 9개 모듈 + Widget/Watch 타겟
• AppProduct/ (레거시 xcodeproj) — v2.2.0에 동결, 열람/참고 전용

---

이 위키는 저장소의 CLAUDE.md 및 docs/claude/ 문서를 사람이 읽기 쉽게 재구성한 것입니다. AI 에이전트(Claude Code) 작업 지침의 원본은 저장소 내 CLAUDE.md를 따릅니다.