Skip to content

๐Ÿ”ง [Chore] Stella ๋ฅผ ๋…๋ฆฝ ๋ ˆํฌ๋กœ ๋ถ„๋ฆฌํ•˜๊ณ  iOS ๋ ˆํฌ์—์„œ ์ œ๊ฑฐ (#1294) - #1295

Merged
JEONG-J merged 1 commit into
developfrom
chore/1294
Sep 7, 2026
Merged

๐Ÿ”ง [Chore] Stella ๋ฅผ ๋…๋ฆฝ ๋ ˆํฌ๋กœ ๋ถ„๋ฆฌํ•˜๊ณ  iOS ๋ ˆํฌ์—์„œ ์ œ๊ฑฐ (#1294)#1295
JEONG-J merged 1 commit into
developfrom
chore/1294

Conversation

@JEONG-J

@JEONG-J JEONG-J commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

๐Ÿ”— ๊ด€๋ จ ์ด์Šˆ

Closes #1294

โœจ PR ์œ ํ˜•

Chore โ€” Stella(API ์ปค๋ฒ„๋ฆฌ์ง€ ๋„๊ตฌ)๋ฅผ ๋…๋ฆฝ ๋ ˆํฌ๋กœ ๋ถ„๋ฆฌํ•˜๊ณ  ์ด ๋ ˆํฌ์—์„œ ์™„์ „ํžˆ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค.

macOS ์•ฑ ๋ ˆํฌ(UMC-PRODUCT/umc-product-macOS)๊ฐ€ ์ƒ๊ธฐ๋ฉด์„œ Stella ๋Š” iOSยทmacOS ๋‘ ํด๋ผ์ด์–ธํŠธ๊ฐ€ ๊ณต์œ ํ•˜๋Š” ๋„๊ตฌ๊ฐ€ ๋์Šต๋‹ˆ๋‹ค. ์†Œ๋น„์ž ๋ ˆํฌ ํ•˜๋‚˜ ์•ˆ์— ๋‘๊ณ  ๋‹ค๋ฅธ ๋ ˆํฌ๊ฐ€ ๋Œ์–ด๋‹ค ์“ฐ๋Š” ๊ตฌ์กฐ๋Š” ์œ ์ง€๊ฐ€ ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ UMC-PRODUCT/umc-product-stella ๋กœ ์˜ฎ๊ฒผ์Šต๋‹ˆ๋‹ค. git subtree split ์œผ๋กœ ๋ฝ‘์•„์„œ ๊ธฐ์กด ์ปค๋ฐ‹ 10๊ฐœ๋ฅผ ๊ทธ๋Œ€๋กœ ๋ณด์กดํ–ˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ“ท ์Šคํฌ๋ฆฐ์ƒท or ์˜์ƒ(UI ๋ณ€๊ฒฝ ์‹œ)

ํ•ด๋‹น ์—†์Œ (์•ฑ ์ฝ”๋“œ ๋ณ€๊ฒฝ ์—†์Œ).

๐Ÿ› ๏ธ ์ž‘์—…๋‚ด์šฉ

์ œ๊ฑฐ

  • Stella/ ๋””๋ ‰ํ„ฐ๋ฆฌ ์ „์ฒด
  • tools/api-coverage/{authors.yml, owners.yml} โ€” ์ƒˆ ๋ ˆํฌ ๋ฃจํŠธ๋กœ ์ด๋™

์œ ์ง€ (์ˆ˜์ •) โ€” .github/workflows/api-coverage.yml

  • ์ปค๋ฒ„๋ฆฌ์ง€ ๋ฆฌํฌํŠธ๋Š” ์ด ๋ ˆํฌ์˜ ์‚ฐ์ถœ๋ฌผ์ด๋ผ ์›Œํฌํ”Œ๋กœ๋Š” ์—ฌ๊ธฐ ๋‚จ์Šต๋‹ˆ๋‹ค. ์‹œํฌ๋ฆฟ(UMC_API_USER/UMC_API_PASS)ยทGitHub Pages ํƒ€๊นƒยทdevelop ํ‘ธ์‹œ ํŠธ๋ฆฌ๊ฑฐ๊ฐ€ ์ „๋ถ€ ์ด ๋ ˆํฌ ์†Œ์œ ์ž…๋‹ˆ๋‹ค. macOS ๋Š” ๋‚˜์ค‘์— ์ž๊ธฐ ๋ ˆํฌ์— ๊ฐ™์€ ํ˜•ํƒœ์˜ ์žก์„ ๋”ฐ๋กœ ๋‘ก๋‹ˆ๋‹ค.
  • Stella ๋ฅผ .stella/ ๋กœ ํฌ๋กœ์Šค ๋ ˆํฌ ์ฒดํฌ์•„์›ƒํ•˜๋„๋ก ๋ณ€๊ฒฝ. ๋‘ ๋ ˆํฌ ๋ชจ๋‘ public ์ด๋ผ ํ† ํฐ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.
  • .stella/ ๊ฐ€ ์˜› Stella/ ์™€ ๊ฐ™์€ ๊นŠ์ด๋ผ ์Šค์บ” ์ƒ๋Œ€ ๊ฒฝ๋กœ(../AppProduct, ../UMCApp, --blame-root ..)๋Š” ๊ทธ๋Œ€๋กœ์ž…๋‹ˆ๋‹ค.
  • ํŠธ๋ฆฌ๊ฑฐ paths ์—์„œ Stella/** ์ œ๊ฑฐ

๊ฐ™์ด ๊ณ ์นœ ๊ธฐ์กด ๊ฒฐํ•จ 2๊ฑด

  1. fetch-depth: 0 ์ถ”๊ฐ€ โ€” actions/checkout@v4 ๊ธฐ๋ณธ๊ฐ’์ด shallow(depth: 1)๋ผ git blame ์ด ๋ชจ๋“  ์ค„์„ ๋‹จ์ผ ์ปค๋ฐ‹์— ๊ท€์†์‹œํ‚ค๊ณ  ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค. ์—”๋“œํฌ์ธํŠธ๋ณ„ ์ž‘์„ฑ์ž๊ฐ€ ํ†ต์งธ๋กœ ์ž˜๋ชป ๋‚˜์˜ค๋˜ ์ƒํƒœ์ž…๋‹ˆ๋‹ค.
  2. ๋งคํ•‘ YAML 3์ข… ์œ„์น˜ ์ •๋ฆฌ โ€” authors.yml/owners.yml ์€ tools/api-coverage/ ์—, overrides.yml ์€ ํ…Œ์ŠคํŠธ ํ”ฝ์Šค์ฒ˜ ๋””๋ ‰ํ„ฐ๋ฆฌ์ธ Stella/Fixtures/ ์— ํฉ์–ด์ ธ ์žˆ์—ˆ๋Š”๋ฐ ์›Œํฌํ”Œ๋กœ๋Š” ํŒจํ‚ค์ง€ ๋ฃจํŠธ๋ฅผ ๋ณด๊ณ  ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค. ์ฆ‰ CI ๊ฐ€ ์…‹ ๋‹ค ๋ชป ์ฐพ์•˜์Šต๋‹ˆ๋‹ค. ์ƒˆ ๋ ˆํฌ ๋ฃจํŠธ๋กœ ํ†ตํ•ฉํ•ด ์ด์ œ ์‹ค์ œ๋กœ ํ”ฝ์—…๋ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œ

  • README.md โ€” Stella ํ•ญ๋ชฉ์„ ์ƒˆ ๋ ˆํฌ ์œ„ํ‚ค๋กœ ๋งํฌ, ์ด ๋ ˆํฌ์—๋Š” ์›Œํฌํ”Œ๋กœ๋งŒ ๋‚จ์•˜๋‹ค๊ณ  ๋ช…์‹œ
  • ์œ„ํ‚ค Stella ํŽ˜์ด์ง€๋Š” ์ด๊ด€ ์•ˆ๋‚ด ์Šคํ…์œผ๋กœ ์ถ•์†Œํ•˜๊ณ  ๋ณธ๋ฌธ์€ Stella ์œ„ํ‚ค ๋กœ ์ด์ „. _SidebarยทHomeยทNetworkingยทBuild-and-RunยทGit-Workflow ์˜ ๋งํฌ๋„ ์™ธ๋ถ€๋กœ ๊ต์ฒด (์œ„ํ‚ค๋Š” ๋ณ„๋„ ํ‘ธ์‹œ)

๐Ÿ“‹ ์ถ”ํ›„ ์ง„ํ–‰ ์ƒํ™ฉ

  • macOS ์Šค์บ” ์ง€์› (Stella ๋ ˆํฌ ์ด์Šˆ๋กœ ๋“ฑ๋ก ์˜ˆ์ •) โ€” apicov scan ์ด --app-product/--umc-app ๋‘ ํ”Œ๋ž˜๊ทธ๋กœ ๊ณ ์ •๋ผ ์žˆ์–ด(Sources/apicov/Commands/ScanCommand.swift:24-27) ์ง€๊ธˆ์€ macOS ํ”„๋กœ์ ํŠธ๋ฅผ ์Šค์บ”ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์ฝ”์–ด์˜ ProjectInput ์€ ์ด๋ฏธ ๋ฒ”์šฉ ๊ตฌ์กฐ๋ผ CLI ํ”Œ๋ž˜๊ทธ์™€ GUI ์Šค์บ” ํผ๋งŒ ์ผ๋ฐ˜ํ™”ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค. ์ด๊ฒŒ ๋๋‚˜์•ผ macOS ๋ ˆํฌ์— ์ปค๋ฒ„๋ฆฌ์ง€ ์žก์„ ๋ถ™์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ๋ถ„๋ฆฌ ํ›„ ์ฒซ ์‹คํ–‰์€ workflow_dispatch ๋กœ ์ˆ˜๋™ ํŠธ๋ฆฌ๊ฑฐํ•ด ํฌ๋กœ์Šค ๋ ˆํฌ ์ฒดํฌ์•„์›ƒ๊ณผ blame ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•˜๋Š” ๊ฒŒ ์ข‹์Šต๋‹ˆ๋‹ค.

๐Ÿ“Œ ๋ฆฌ๋ทฐ ํฌ์ธํŠธ

  • .stella/ ๊ฒฝ๋กœ ๊นŠ์ด โ€” ์Šค์บ” ์ƒ๋Œ€ ๊ฒฝ๋กœ๋ฅผ ๊ทธ๋Œ€๋กœ ๋‘๋ ค๊ณ  ์ฒดํฌ์•„์›ƒ ๊ฒฝ๋กœ๋ฅผ ์˜› Stella/ ์™€ ๊ฐ™์€ ๊นŠ์ด๋กœ ๋งž์ท„์Šต๋‹ˆ๋‹ค. ์›Œํฌํ”Œ๋กœ์˜ working-directory: .stella ์™€ --blame-root .. ์กฐํ•ฉ์ด ๋งž๋Š”์ง€ ๋ด์ฃผ์„ธ์š”.
  • fetch-depth: 0 ๋น„์šฉ โ€” ํžˆ์Šคํ† ๋ฆฌ ์ „์ฒด๋ฅผ ๋ฐ›์œผ๋ฏ€๋กœ ์ฒดํฌ์•„์›ƒ์ด ๋А๋ ค์ง‘๋‹ˆ๋‹ค. blame ์ •ํ™•๋„์™€ ๋งž๋ฐ”๊พผ ์„ ํƒ์ž…๋‹ˆ๋‹ค.
  • ์›Œํฌํ”Œ๋กœ๋ฅผ ์ด ๋ ˆํฌ์— ๋‚จ๊ธด ํŒ๋‹จ โ€” ๋„๊ตฌ๋Š” ๊ณต์œ ํ•˜๋˜ "์ปค๋ฒ„๋ฆฌ์ง€ ์žก"์€ ์†Œ๋น„์ž ๋ ˆํฌ๊ฐ€ ๊ฐ์ž ์†Œ์œ ํ•œ๋‹ค๋Š” ์ „์ œ์ž…๋‹ˆ๋‹ค. Stella ๋ ˆํฌ์— ํ†ตํ•ฉ ์žก์„ ๋‘๋ฉด ํ•œ ๋ ˆํฌ๊ฐ€ ๋‘ ์†Œ๋น„์ž์˜ ์‹œํฌ๋ฆฟ์„ ๊ฐ–๊ณ  ๋ฆฌํฌํŠธ๋„ ๋‘ ๋ฒŒ ๋‚˜์˜ต๋‹ˆ๋‹ค.

โœ… Checklist

PR์ด ๋‹ค์Œ ์š”๊ตฌ ์‚ฌํ•ญ์„ ์ถฉ์กฑํ•˜๋Š”์ง€ ํ™•์ธํ•ด์ฃผ์„ธ์š”!!!

  • ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€ ์ปจ๋ฒค์…˜์— ๋งž๊ฒŒ ์ž‘์„ฑํ–ˆ์Šต๋‹ˆ๋‹ค
  • ์œ ์ง€-๋ณด์ˆ˜๋ฅผ ์œ„ํ•ด ์ฃผ์„์ฒ˜๋ฆฌ๋ฅผ ์ž˜ ์ž‘์„ฑํ•˜์˜€๋Š”๊ฐ€?

macOS ์•ฑ ๋ ˆํฌ๊ฐ€ ์ƒ๊ธฐ๋ฉด์„œ Stella ์˜ ์†Œ๋น„์ž๊ฐ€ ๋‘˜์ด ๋๋‹ค. ๋‘ ๋ ˆํฌ๊ฐ€ ํ•จ๊ป˜ ์“ธ
๋„๊ตฌ๊ฐ€ ๊ทธ์ค‘ ํ•œ์ชฝ ์•ˆ์— ์‚ฌ๋Š” ๊ตฌ์กฐ๋Š” ์œ ์ง€๋˜๊ธฐ ์–ด๋ ค์›Œ ๋ณ„๋„ ๋ ˆํฌ๋กœ ๋บ€๋‹ค.

- Stella/ ์™€ tools/api-coverage/ ์ œ๊ฑฐ (ํžˆ์Šคํ† ๋ฆฌ๋Š” subtree split ์œผ๋กœ ๋ณด์กด)
- api-coverage.yml ์€ ๋‚จ๊ธด๋‹ค. ๋ฆฌํฌํŠธยท์‹œํฌ๋ฆฟยทPagesยทํŠธ๋ฆฌ๊ฑฐ๊ฐ€ ๋ชจ๋‘ ์†Œ๋น„์ž๋ณ„๋กœ
  ๋‹ค๋ฅด๋ฏ€๋กœ ์Šค์บ” ์žก์€ ์†Œ๋น„์ž ๋ ˆํฌ๊ฐ€ ์†Œ์œ ํ•˜๊ณ , ์Šค์บ๋„ˆ๋งŒ ์ฒดํฌ์•„์›ƒํ•ด ์“ด๋‹ค.
- ์ด๊ด€ ์ค‘ ํ™•์ธ๋œ ๊ฒฐํ•จ ํ•˜๋‚˜๋ฅผ ํ•จ๊ป˜ ๊ณ ์นœ๋‹ค. checkout ์ด ์–•์€ ํด๋ก ์ด๋ผ
  git blame ์ด ๋ชจ๋“  ์ค„์„ ์ฒดํฌ์•„์›ƒ ์ปค๋ฐ‹ ํ•˜๋‚˜๋กœ ์žก๋˜ ๋ฌธ์ œ โ†’ fetch-depth: 0

์ƒˆ ๋ ˆํฌ: https://github.com/UMC-PRODUCT/umc-product-stella
@JEONG-J JEONG-J added the ๐Ÿ”ง chore ํ”„๋กœ์ ํŠธ ์„ธํŒ…, ๋นŒ๋“œ ์„ค์ •, ์˜์กด์„ฑ ๊ด€๋ฆฌ ๋“ฑ ๊ธฐํƒ€ ์ž‘์—…์ž…๋‹ˆ๋‹ค. label Sep 7, 2026
@JEONG-J JEONG-J self-assigned this Sep 7, 2026
@JEONG-J
JEONG-J merged commit e8573fc into develop Sep 7, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

๐Ÿ”ง chore ํ”„๋กœ์ ํŠธ ์„ธํŒ…, ๋นŒ๋“œ ์„ค์ •, ์˜์กด์„ฑ ๊ด€๋ฆฌ ๋“ฑ ๊ธฐํƒ€ ์ž‘์—…์ž…๋‹ˆ๋‹ค.

Projects

None yet

1 participant