// readme

To-do Calendar

ํ• ์ผ ๋ชฉ๋ก์ด ์žˆ๋Š” iOS ๋‹ฌ๋ ฅ ์•ฑ

---|---|---|---

What is To-do Calendar?

To-do Calendar๋Š” ํ• ์ผ ๋ชฉ๋ก์„ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ๋Š” ๋‹ฌ๋ ฅ ์•ฑ ์ž…๋‹ˆ๋‹ค. ์•ฑ์ด ์ œ๊ณตํ•˜๋Š” ๋‹ค์Œ์˜ ๊ธฐ๋Šฅ๋“ค์„ ์ด์šฉํ•˜์—ฌ ์ผ์ • ๋ฐ ํ• ์ผ์„ ๊ด€๋ฆฌํ•˜์„ธ์š”.

  • ์ผ๋ฐ˜ ๋‹ฌ๋ ฅ์•ฑ๊ณผ ๊ฐ™์ด ์ผ์ •์„ ๋‹ฌ๋ ฅ์— ์ถ”๊ฐ€ํ•˜์„ธ์š”.
  • ํ• ์ผ๋„ ๋‹ฌ๋ ฅ์— ์ถ”๊ฐ€ํ•˜์—ฌ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ถ”๊ฐ€ํ•œ ์ผ์ • ๋ฐ ํ• ์ผ์— ๋ฏธ๋ฆฌ์•Œ๋ฆผ์„ ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜, ์ด ์ค‘ ์ œ์ผ ์ค‘์š”ํ•œ ์ด๋ฒคํŠธ๋ฅผ ๋“ฑ๋กํ•˜์„ธ์š”.
  • ์•ฑ์ด ์ œ๊ณตํ•˜๋Š” ๋‹ค์–‘ํ•œ ์ข…๋ฅ˜์˜ ์œ„์ ฏ์„ ์‚ฌ์šฉํ•˜์—ฌ ๋” ๊ฐ„ํŽธํ•˜๊ฒŒ ์ผ์ •์„ ๊ด€๋ฆฌํ•˜์„ธ์š”.

Install

  1. ์ด repository๋ฅผ ํด๋ก  ๋ฐ›๊ณ  develop ๋ธŒ๋žœ์น˜๋ฅผ checkout ํ•ฉ๋‹ˆ๋‹ค.

  2. clone ๋ฐ›์€ ํ”„๋กœ์ ํŠธ ๋””๋ ‰ํ† ๋ฆฌ๋กœ ์ด๋™ํ•˜์—ฌ ./install/install.sh๋ฅผ ์‹คํ–‰ํ•ด์ฃผ์„ธ์š”. ํ”„๋กœ์ ํŠธ ๋นŒ๋“œ๋ฅผ ์œ„ํ•ด ํ•„์š”ํ•œ ๋”๋ฏธ ํŒŒ์ผ๋“ค์ด ํ•„์š”ํ•œ ์œ„์น˜๋กœ ์ด๋™๋ฉ๋‹ˆ๋‹ค.

  3. mise๋ฅผ ์„ค์น˜ํ•˜๊ณ , ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์—์„œ Tuist๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

    brew install mise
mise install      # mise.toml์— ์ •์˜๋œ tuist ๋ฒ„์ „ ์ž๋™ ์„ค์น˜

  4. ๋‹ค์Œ์„ ์‹คํ–‰ํ•˜์—ฌ dependency๋ฅผ ์„ค์น˜ํ•˜๊ณ  Xcode project๋ฅผ ์ƒ์„ฑํ•˜์„ธ์š”

    tuist install
tuist generate --no-open

  5. ์ƒ์„ฑ๋œ TodoCalendar.xcworkspace๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ Xcode๋ฅผ ์‹คํ–‰์‹œํ‚ต๋‹ˆ๋‹ค.

  6. TodoCalendarApp Scheme ์„ ์„ ํƒํ•˜๊ณ  ์•ฑ์„ ์‹คํ–‰์‹œํ‚ต๋‹ˆ๋‹ค

ํด๋ก ๋ฐ›์€ ์•ฑ์€ ์˜คํ”„๋ผ์ธ ๋ชจ๋“œ๋กœ๋งŒ ์‚ฌ์šฉ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.(๋กœ๊ทธ์ธ ๋ฐ ๊ณ„์ • ๊ด€๋ จ ๊ธฐ๋Šฅ ์ •์ƒ๋™์ž‘ x) ํ•ด๋‹น ๊ธฐ๋Šฅ์„ ํฌํ•จํ•˜์—ฌ ๋นŒ๋“œํ•˜๋ ค๋Š” ๊ฒฝ์šฐ ๋ฌธ์˜ํ•ด์ฃผ์„ธ์š”

ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

Domain

Domain
โ”œโ”€โ”€ Models
โ”œโ”€โ”€ Repositories
โ”œโ”€โ”€ Usecases
โ””โ”€โ”€ Utils

์„œ๋น„์Šค ๊ตฌํ˜„์„ ์œ„ํ•œ Model๊ณผ Usecase ๊ตฌํ˜„์ฒด๊ฐ€ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค.โ€ฆ

โ†‘ The Undervalued Score +

How much a project earns versus how much attention it actually gets. Above 50 means the work is outrunning its audience. Recomputed nightly from commit velocity, contributor effort, issue resolution, fork utility, release cadence, and project maturity โ€” divided by a logarithmic reach factor.

score  = signal / reach

signal = 0.25ยทcommit_velocity   // commits in last 90 days (cap 30)
       + 0.20ยทcontributor_work  // unique authors ร— velocity (cap 100)
       + 0.20ยทissue_resolution  // closed รท total issues
       + 0.20ยทfork_ratio        // forks รท stars (proxy for real usage)
       + 0.10ยทrelease_cadence   // releases in 90 days (cap 3)
       + age_bonus              // +0 to +0.30 after 6 months
       + homepage_bonus         // +0.05 if homepage is set

reach  = logโ‚โ‚€(stars + watchers + 10)โ–ˆ
โ™ฅ The Health Score +

Is the project alive and maintained right now? A 0โ€“100 pulse recomputed nightly from commit recency, rhythm, how fast issues close, and how quickly PRs get merged.

health = 0.35ยทrecency       // days since last commit (90d decay)
       + 0.25ยทcadence       // commit rhythm consistency
       + 0.20ยทissue_health  // closed รท total issues
       + 0.20ยทpr_health     // merged รท total PRsโ–ˆ
โ—ท Health bands +

The colour and label on every card come straight from the health score.

Healthy   80 โ€“ 100   active, responsive, regular releases
Stable    60 โ€“ 79    maintained, steady, no alarms
Quiet     40 โ€“ 59    slowing down โ€” watch this one
At Risk    0 โ€“ 39    going dark ยท candidate for rescueโ–ˆ
// Tags โ€” what each label means +

Tags are independent behavioral signals computed nightly. A project can hold multiple at once. They drive the home page sections.

solo_builder      one person holds > 80% of commits (last 180d)
needs_contributors has open "help wanted" or "good first issue" labels
hidden_gem        < 100 stars ยท active in last 3 months ยท documented
legacy_hero       repo > 5 years old ยท committed this year
fork_magnet       forks/stars > 0.5 ยท used as template or dependency
release_machine   5+ releases in the last 90 days
under_pressure    > 10 open issues ยท โ‰ค 2 contributors ยท health โ‰ฅ 60
community_watch   watchers > stars ยท devs tracking before the public
community_hub     GitHub Discussions enabled ยท > 20 discussions
funded            maintainer has active funding channelโ–ˆ
โ˜… Why rank against stars at all? +

Stars are an outcome, not effort. A project with 8 stars and daily commits is doing more interesting work than one coasting on 8k. We measure the building, then divide by the attention already received โ€” so the genuinely undervalued rise to the top.

// stars   = lagging indicator
// commits = leading indicator
// we rank by the leading oneโ–ˆ