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, Router
Coding Conventions	절대 규칙, 코딩 스타일, 네이밍 규칙
Error Handling	Loadable · ErrorHandler · AlertPrompt 선택 기준
Networking	Moya Router 설계, Response DTO 디코딩 규칙
Design System	디자인 토큰, Typography, Glass, 성능 최적화
Module Structure	Tuist(UMCApp) 모듈 구조, 의존성 방향
Build & Run	빌드 명령, 시크릿 설정, 테스트
Git Workflow	브랜치 전략, 커밋·PR·배포 규칙
Release History	기수별 팀 구성·신규 기능·운영 기록

🧭 한눈에 보기

기술 스택: Swift 6.3 · SwiftUI(iOS 26 Liquid Glass) · Tuist · Moya · Kingfisher · SwiftData

아키텍처

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

두 빌드 축

• UMCApp/ (Tuist) — 모든 신규·유지보수 작업의 대상
• AppProduct/ (레거시 xcodeproj) — v2.2.0에 동결, 열람/참고 전용

---

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