Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,14 @@ View ←→ ViewModel(@Observable) β†’ UseCase(Protocol) β†’ Repository β†’ Data
- μ‹€μˆ˜λ‘œ `AppProduct/`κ°€ λ³€κ²½λ˜λ©΄ μ¦‰μ‹œ `git restore --source=v2.2.0 -- AppProduct/<경둜>` 둜 릴리즈 μƒνƒœλ‘œ λ˜λŒλ¦°λ‹€.
- μœ μΌν•œ μ˜ˆμ™Έ: λ©”μΈν…Œμ΄λ„ˆκ°€ **λͺ…μ‹œμ μœΌλ‘œ AppProduct μˆ˜μ •μ„ μ§€μ‹œν•œ κ²½μš°μ—λ§Œ** μ§„ν–‰. κ·Έ μ™Έμ—λŠ” μ˜ˆμ™Έ μ—†μŒ.

10. **μž‘μ—… 브랜치λͺ…은 `{νƒ€μž…}/{이슈번호}` β€” 이슈λ₯Ό λ¨Όμ € λ§Œλ“€κ³  κ·Έ 번호λ₯Ό μ“΄λ‹€.**
νƒ€μž…μ€ 이슈 ν…œν”Œλ¦Ώκ³Ό 1:1둜 λ§žμΆ˜λ‹€: `feat` Β· `bug` Β· `design` Β· `refac` Β· `docs` Β· `chore`.
(예: `docs/1203`, `feat/1195`) μ„€λͺ…ν˜• 브랜치λͺ…(`docs/repo-rename-links` λ“±) κΈˆμ§€.
- λŒ€μ‘ μ΄μŠˆκ°€ μ—†μœΌλ©΄ **브랜치λ₯Ό λ§Œλ“€κΈ° 전에 μ΄μŠˆλΆ€ν„° 생성**ν•œλ‹€ (제λͺ© 접두사·라벨·TypeΒ·Priority/EffortκΉŒμ§€ μ±„μ›Œμ„œ β€” 상세: `docs/claude/git-workflow.md`).
- PR 제λͺ© 끝에 `(#이슈번호)`, 본문에 `Closes #이슈번호`λ₯Ό λ„£μ–΄ μ΄μŠˆμ™€ μ—°κ²°ν•œλ‹€.
- 이미 ν‘Έμ‹œν•œ 브랜치λͺ…을 고쳐야 ν•˜λ©΄ GitHub 브랜치 rename APIλŠ” **μ—΄λ € 있던 PR을 λ‹«μ•„λ²„λ¦¬λ―€λ‘œ**, rename ν›„ μƒˆ PR을 λ§Œλ“€κ³  λ‹«νžŒ PR에 후속 PR 번호λ₯Ό μ½”λ©˜νŠΈλ‘œ 남긴닀.
- 배포 λΈŒλžœμΉ˜λŠ” μ˜ˆμ™Έ: `testFlight/{번호}` Β· `release/{번호}` (순차 번호, 이슈번호 μ•„λ‹˜).

## μ½”λ”© μŠ€νƒ€μΌ (μš”μ•½)

- λ“€μ—¬μ“°κΈ° 4 spaces(νƒ­ κΈˆμ§€) Β· 쀄 길이 μ΅œλŒ€ 99자 Β· μ™ΈλΆ€ λΆˆν•„μš” μƒνƒœλŠ” `private`
Expand Down
32 changes: 16 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

UMC(University MakeUs Challenge) 동아리 μš΄μ˜μ„ ν•˜λ‚˜μ˜ μ•±μœΌλ‘œ ν†΅ν•©ν•˜λŠ” iOS ν΄λΌμ΄μ–ΈνŠΈ

[![Release](https://img.shields.io/github/v/release/UMC-PRODUCT/umc-product-iOS?label=release&color=blue)](https://github.com/UMC-PRODUCT/umc-product-iOS/releases)
[![Release](https://img.shields.io/github/v/release/UMC-PRODUCT/Big-Dipper-iOS?label=release&color=blue)](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/releases)
[![Swift](https://img.shields.io/badge/Swift-6.3-orange.svg)]()
[![Xcode](https://img.shields.io/badge/Xcode-26.2-1575F9.svg)]()
[![iOS](https://img.shields.io/badge/iOS-26.0+-black.svg)]()
Expand Down Expand Up @@ -42,32 +42,32 @@ UMC(University MakeUs Challenge) 동아리 μš΄μ˜μ„ ν•˜λ‚˜μ˜ μ•±μœΌλ‘œ 톡합

</div>

> κΈ°μˆ˜λ³„ νŒ€μ› ꡬ성(사진·역할·GitHub)은 [Wiki β€Ί Team](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Team)μ—μ„œ,
> μ‹ κ·œ κΈ°λŠ₯·운영 기둝은 [Wiki β€Ί Release History](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Release-History)μ—μ„œ ν™•μΈν•˜μ„Έμš”.
> κΈ°μˆ˜λ³„ νŒ€μ› ꡬ성(사진·역할·GitHub)은 [Wiki β€Ί Team](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Team)μ—μ„œ,
> μ‹ κ·œ κΈ°λŠ₯·운영 기둝은 [Wiki β€Ί Release History](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Release-History)μ—μ„œ ν™•μΈν•˜μ„Έμš”.

## πŸ“š 개발 λ¬Έμ„œ (Wiki)

μ•„ν‚€ν…μ²˜Β·μ½”λ”© μ»¨λ²€μ…˜Β·λΉŒλ“œ 방법 λ“± 상세 κ°€μ΄λ“œλŠ” λͺ¨λ‘ **[Wiki](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki)** 둜 μ΄κ΄€ν–ˆμŠ΅λ‹ˆλ‹€.
μ•„ν‚€ν…μ²˜Β·μ½”λ”© μ»¨λ²€μ…˜Β·λΉŒλ“œ 방법 λ“± 상세 κ°€μ΄λ“œλŠ” λͺ¨λ‘ **[Wiki](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki)** 둜 μ΄κ΄€ν–ˆμŠ΅λ‹ˆλ‹€.

| 주제 | λ¬Έμ„œ |
|------|------|
| πŸ—οΈ μ•„ν‚€ν…μ²˜ | [Architecture](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Architecture) |
| πŸ“ μ ˆλŒ€ κ·œμΉ™ & μ½”λ”© μ»¨λ²€μ…˜ | [Coding Conventions](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Coding-Conventions) |
| ⚠️ μ—λŸ¬ 처리 | [Error Handling](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Error-Handling) |
| 🌐 λ„€νŠΈμ›Œν¬ & DTO λ””μ½”λ”© | [Networking](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Networking) |
| 🎨 λ””μžμΈ μ‹œμŠ€ν…œ | [Design System](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Design-System) |
| 🧱 λͺ¨λ“ˆ ꡬ쑰 (Tuist) | [Module Structure](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Module-Structure) |
| βš™οΈ λΉŒλ“œ & μ‹€ν–‰ | [Build & Run](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Build-and-Run) |
| πŸ”€ Git μ›Œν¬ν”Œλ‘œμš° | [Git Workflow](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Git-Workflow) |
| πŸ›°οΈ API 컀버리지 (Stella) | [Stella](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Stella) |

> μ‹ κ·œ ν•©λ₯˜μžλŠ” [Wiki Home](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki) β†’ **λΉŒλ“œ & μ‹€ν–‰** μˆœμ„œλ‘œ μ‹œμž‘ν•˜μ„Έμš”.
| πŸ—οΈ μ•„ν‚€ν…μ²˜ | [Architecture](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Architecture) |
| πŸ“ μ ˆλŒ€ κ·œμΉ™ & μ½”λ”© μ»¨λ²€μ…˜ | [Coding Conventions](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Coding-Conventions) |
| ⚠️ μ—λŸ¬ 처리 | [Error Handling](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Error-Handling) |
| 🌐 λ„€νŠΈμ›Œν¬ & DTO λ””μ½”λ”© | [Networking](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Networking) |
| 🎨 λ””μžμΈ μ‹œμŠ€ν…œ | [Design System](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Design-System) |
| 🧱 λͺ¨λ“ˆ ꡬ쑰 (Tuist) | [Module Structure](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Module-Structure) |
| βš™οΈ λΉŒλ“œ & μ‹€ν–‰ | [Build & Run](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Build-and-Run) |
| πŸ”€ Git μ›Œν¬ν”Œλ‘œμš° | [Git Workflow](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Git-Workflow) |
| πŸ›°οΈ API 컀버리지 (Stella) | [Stella](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Stella) |

> μ‹ κ·œ ν•©λ₯˜μžλŠ” [Wiki Home](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki) β†’ **λΉŒλ“œ & μ‹€ν–‰** μˆœμ„œλ‘œ μ‹œμž‘ν•˜μ„Έμš”.

## πŸ”‘ μ‹œν¬λ¦Ώ μ„€μ •

- `Secrets.xcconfig`(`BASE_URL`, `KAKAO_KEY`)와 `GoogleService-Info.plist`λŠ” **νŒ€ λ‚΄λΆ€ 채널**μ—μ„œ μˆ˜λ Ήν•©λ‹ˆλ‹€.
- μ‹€μ œ ν‚€Β·μ„€μ • νŒŒμΌμ€ 원격 μ €μž₯μ†Œμ— μ»€λ°‹ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
- 상세 절차: [Build & Run β€Ί μ‹œν¬λ¦Ώ μ„€μ •](https://github.com/UMC-PRODUCT/umc-product-iOS/wiki/Build-and-Run)
- 상세 절차: [Build & Run β€Ί μ‹œν¬λ¦Ώ μ„€μ •](https://github.com/UMC-PRODUCT/Big-Dipper-iOS/wiki/Build-and-Run)

---

Expand Down
2 changes: 1 addition & 1 deletion UMCApp/MAKEFILE_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ make generate
## 8. 파일 ꡬ쑰 참고

```
umc-product-iOS/
Big-Dipper-iOS/
β”œβ”€β”€ UMCApp/
β”‚ β”œβ”€β”€ Makefile # ← 이 κ°€μ΄λ“œκ°€ μ„€λͺ…ν•˜λŠ” 파일
β”‚ β”œβ”€β”€ MAKEFILE_GUIDE.md # ← 이 λ¬Έμ„œ
Expand Down
8 changes: 7 additions & 1 deletion docs/claude/git-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ Git Flow + **연속 브랜치 νŒŒμƒ** 지원

## 브랜치 μ „λž΅

- **브랜치λͺ…은 `{νƒ€μž…}/{이슈번호}`** β€” νƒ€μž…μ€ 이슈 ν…œν”Œλ¦Ώκ³Ό 1:1(`feat`/`bug`/`design`/`refac`/`docs`/`chore`),
baseΒ·PR λŒ€μƒμ€ `develop`. 예: `docs/1203`, `feat/1195`. μ„€λͺ…ν˜• 브랜치λͺ… κΈˆμ§€.
- λŒ€μ‘ μ΄μŠˆκ°€ μ—†μœΌλ©΄ **브랜치λ₯Ό λ§Œλ“€κΈ° 전에 μ΄μŠˆλΆ€ν„° 생성**ν•œλ‹€ (μ•„λž˜ "이슈 생성 κ·œμΉ™").
- PR 제λͺ© 끝에 `(#이슈번호)`, 본문에 `Closes #이슈번호`.
- ν‘Έμ‹œν•œ 브랜치λͺ…을 고쳐야 ν•˜λ©΄ GitHub 브랜치 rename APIκ°€ **μ—΄λ € 있던 PR을 닫아버린닀.**
rename ν›„ μƒˆ PR을 λ§Œλ“€κ³ , λ‹«νžŒ PR에 후속 PR 번호λ₯Ό μ½”λ©˜νŠΈλ‘œ 남긴닀.
- **연속 브랜치**: featureμ—μ„œ λ‹€μŒ feature νŒŒμƒ κ°€λŠ₯ (ν‹°μΌ“ λ‹¨μœ„ 뢄리)
- **PR λŒ€κΈ° 쀑 μž‘μ—…**: 승인 λŒ€κΈ° 쀑 이전 λΈŒλžœμΉ˜μ—μ„œ λ‹€μŒ 브랜치 생성 κ°€λŠ₯
- **동기화**: developμ—μ„œ merge λŒ€μ‹  `fetch + rebase` μ‚¬μš©
Expand Down Expand Up @@ -66,7 +72,7 @@ Git Flow + **연속 브랜치 νŒŒμƒ** 지원
- **이슈 Type** (쑰직 레벨): ν˜„μž¬ `Task` / `Bug` / `Feature` 3μ’…λ§Œ 쑴재 β†’ Bug/Feature μ™Έ ν…œν”Œλ¦Ώμ€ `Task`둜 λ§€ν•‘.
`gh issue create`μ—” `--type` ν”Œλž˜κ·Έκ°€ μ—†μœΌλ―€λ‘œ(gh 2.83.1) **생성 직후 REST둜 μ„€μ •**ν•œλ‹€:
```bash
gh api --method PATCH repos/UMC-PRODUCT/umc-product-iOS/issues/{번호} -f type=Feature
gh api --method PATCH repos/UMC-PRODUCT/Big-Dipper-iOS/issues/{번호} -f type=Feature
```
- **λ³΄λ“œ #3 + `μš°μ„ μˆœμœ„`(Projects v2)**: 생성 μ‹œ **기본으둜 λ³΄λ“œ μΆ”κ°€ + μš°μ„ μˆœμœ„ μ„€μ •**. 단 `project` μŠ€μ½”ν”„ ν•„μš” β€”
없을 λ•Œλ§Œ 이 뢀뢄을 κ±΄λ„ˆλ›°κ³ (Type/라벨은 적용) `gh auth refresh -s project` ν›„ 재적용.
Expand Down
Loading