[Feature] 캘린더 컴포넌트를 구현합니다.

calendar-domain/src/main/java/com/hongikyeolgong2/calendar/model/Calendar.kt

@@ -3,18 +3,35 @@ package com.hongikyeolgong2.calendar.model
 import java.time.LocalDate
 import java.time.YearMonth
 import java.time.format.DateTimeFormatter
+import java.util.Locale
 
 class Calendar(
     initDate: LocalDate = LocalDate.now(),
     private val dateTimeFormatter: DateTimeFormatter =
-        DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT_PATTERN),
+        DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT_PATTERN).withLocale(Locale.ENGLISH),
     private val studyDays: List<StudyDay> = emptyList(),
 ) {
     private var date: LocalDate = initDate
 
     val now: String
         get() = dateTimeFormatter.format(date)
 
+    fun getMonth(): List<StudyDay> {
+        val studyDaysWithMonth = getStudyDaysByMonth()
+        val existingDays = studyDaysWithMonth.associateBy { it.date.dayOfMonth }
+
+        return (1..getLastDayOfMonth()).map { day ->
+            existingDays[day] ?: StudyDay(
+                date = date.withDayOfMonth(day),
+                studyRoomUsage = StudyRoomUsage.NEVER_USED,
+            )
+        }.sortedBy { it.date.dayOfMonth }
+    }
+
+    fun getStudyDaysByMonth(): List<StudyDay> {
+        return studyDays.filter { it.date.month == date.month }
+    }
+
     fun getLastDayOfMonth(): Int {
         return YearMonth.from(date).atEndOfMonth().dayOfMonth
     }
@@ -27,10 +44,6 @@ class Calendar(
         date = date.plusMonths(1)
     }
 
-    fun getStudyDaysByMonth(): List<StudyDay> {
-        return studyDays.filter { it.date.month == date.month }
-    }
-
     companion object {
         private const val DEFAULT_DATE_TIME_FORMAT_PATTERN = "MMM yyyy"
     }

calendar-domain/src/main/java/com/hongikyeolgong2/calendar/model/StudyRoomUsage.kt

@@ -1,6 +1,7 @@
 package com.hongikyeolgong2.calendar.model
 
 enum class StudyRoomUsage {
+    NEVER_USED,
     USED_ONCE,
     USED_ONCE_EXTENDED_ONCE,
     USED_ONCE_EXTENDED_TWICE,

calendar-domain/src/test/kotlin/com/hongikyeolgong2/calendar/model/CalendarTest.kt

@@ -7,6 +7,44 @@ import java.time.format.DateTimeFormatter
 import java.util.Locale
 
 class CalendarTest : BehaviorSpec({
+    Given("현재 날짜가 포함된 달의 모든 날을 가져올 수 있다.") {
+        var date: LocalDate
+        var calendar: Calendar
+        var actual: List<StudyDay>
+
+        When("2024년 1월 5일이 주어지면") {
+            date = LocalDate.of(2024, 1, 5)
+            calendar = Calendar(date)
+
+            Then("31개의 날들이 반환된다") {
+                actual = calendar.getMonth()
+                actual.size shouldBe 31
+            }
+
+            Then("순서를 유지한체 1일부터 31일 까지 반환된다") {
+                actual = calendar.getMonth()
+                actual.first().date shouldBe LocalDate.of(2024, 1, 1)
+                actual.last().date shouldBe LocalDate.of(2024, 1, 31)
+            }
+        }
+
+        When("2024년 2월 15일이 주어지면") {
+            date = LocalDate.of(2024, 2, 15)
+            calendar = Calendar(date)
+
+            Then("29개의 날들이 반환된다") {
+                actual = calendar.getMonth()
+                actual.size shouldBe 29
+            }
+
+            Then("윤년이기 때문에 1부터 29일까지 반환된다.") {
+                actual = calendar.getMonth()
+                actual.first().date shouldBe LocalDate.of(2024, 2, 1)
+                actual.last().date shouldBe LocalDate.of(2024, 2, 29)
+            }
+        }
+    }
+
     Given("LocalDate가 주어지면, 해당 달의 끝날짜를 알 수 있다.") {
         var date: LocalDate
         var calendar: Calendar
@@ -178,8 +216,14 @@ class CalendarTest : BehaviorSpec({
                 actual shouldBe
                     listOf(
                         StudyDay(LocalDate.of(2024, 2, 1), StudyRoomUsage.USED_ONCE),
-                        StudyDay(LocalDate.of(2024, 2, 3), StudyRoomUsage.USED_ONCE_EXTENDED_ONCE),
-                        StudyDay(LocalDate.of(2024, 2, 4), StudyRoomUsage.USED_ONCE_EXTENDED_ONCE),
+                        StudyDay(
+                            LocalDate.of(2024, 2, 3),
+                            StudyRoomUsage.USED_ONCE_EXTENDED_ONCE,
+                        ),
+                        StudyDay(
+                            LocalDate.of(2024, 2, 4),
+                            StudyRoomUsage.USED_ONCE_EXTENDED_ONCE,
+                        ),
                     )
             }
         }

calendar-presentation/.gitignore

@@ -0,0 +1 @@
+/build

calendar-presentation/build.gradle.kts

@@ -0,0 +1,11 @@
+plugins {
+    id("hongikyeolgong2.android.feature")
+}
+
+android {
+    namespace = "com.teamhy2.hongikyeolgong2.calendar.presentation"
+}
+
+dependencies {
+    implementation(projects.calendarDomain)
+}

calendar-presentation/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

calendar-presentation/src/androidTest/java/com/hongikyeolgong2/calendar/presentation/ExampleInstrumentedTest.kt

@@ -0,0 +1,22 @@
+package com.hongikyeolgong2.calendar.presentation
+
+import androidx.test.ext.junit.runners.AndroidJUnit4
+import androidx.test.platform.app.InstrumentationRegistry
+import junit.framework.TestCase.assertEquals
+import org.junit.Test
+import org.junit.runner.RunWith
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+    @Test
+    fun useAppContext() {
+        // Context of the app under test.
+        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+        assertEquals("com.hongikyeolgong2.calendar.presentation.test", appContext.packageName)
+    }
+}

calendar-presentation/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest />

calendar-presentation/src/main/java/com/hongikyeolgong2/calendar/presentation/Calendar.kt

@@ -0,0 +1,210 @@
+package com.hongikyeolgong2.calendar.presentation
+
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.interaction.MutableInteractionSource
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.lazy.grid.GridCells
+import androidx.compose.foundation.lazy.grid.LazyVerticalGrid
+import androidx.compose.foundation.lazy.grid.items
+import androidx.compose.material3.Icon
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.style.TextAlign
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import com.hongikyeolgong2.calendar.model.Calendar
+import com.hongikyeolgong2.calendar.model.StudyDay
+import com.hongikyeolgong2.calendar.model.StudyRoomUsage
+import com.teamhy2.designsystem.R
+import com.teamhy2.designsystem.ui.theme.Gray100
+import com.teamhy2.designsystem.ui.theme.Gray300
+import com.teamhy2.designsystem.ui.theme.HY2Theme
+import com.teamhy2.designsystem.ui.theme.HY2Typography
+import com.teamhy2.hongikyeolgong2.calendar.presentation.R.string.description_next_month
+import com.teamhy2.hongikyeolgong2.calendar.presentation.R.string.description_previous_month
+import java.time.LocalDate
+
+private const val DAY_DEFAULT_MARGIN = 5
+
+@Composable
+fun Hy2Calendar(
+    title: String,
+    days: List<StudyDay>,
+    onPreviousMonthClick: () -> Unit,
+    onNextMonthClick: () -> Unit,
+    modifier: Modifier = Modifier,
+) {
+    Column(modifier = modifier) {
+        CalendarHeader(
+            title = title,
+            onPreviousMonthClick = onPreviousMonthClick,
+            onNextMonthClick = onNextMonthClick,
+        )
+        Spacer(modifier = Modifier.height(12.dp))
+        Row(modifier = Modifier.padding(bottom = 8.dp)) {
+            DayOfWeek.entries.forEach { dayOfWeek ->
+                DayOfWeek(
+                    name = dayOfWeek.abbreviation,
+                    modifier = Modifier.weight(1f),
+                )
+            }
+        }
+        LazyVerticalGrid(
+            columns = GridCells.Fixed(7),
+            verticalArrangement = Arrangement.spacedBy(DAY_DEFAULT_MARGIN.dp),
+            horizontalArrangement = Arrangement.spacedBy(DAY_DEFAULT_MARGIN.dp),
+        ) {
+            items((days.first().date.dayOfWeek.ordinal + 1) % 7) {
+                Box(modifier = Modifier.weight(1f))
+            }
+
+            items(days) {
+                Day(studyDay = it, modifier = Modifier.weight(1f))
+            }
+        }
+    }
+}
+
+@Composable
+fun CalendarHeader(
+    title: String,
+    onPreviousMonthClick: () -> Unit,
+    onNextMonthClick: () -> Unit,
+    modifier: Modifier = Modifier,
+) {
+    Row(
+        modifier = modifier,
+        verticalAlignment = Alignment.CenterVertically,
+    ) {
+        Text(
+            text = title,
+            style = HY2Typography().title01,
+            color = Gray100,
+        )
+        Spacer(modifier = Modifier.weight(1f))
+        Icon(
+            painter = painterResource(id = R.drawable.ic_arrow_left),
+            modifier =
+                Modifier.clickable(
+                    interactionSource = MutableInteractionSource(),
+                    indication = null,
+                    onClick = onPreviousMonthClick,
+                ),
+            tint = Gray300,
+            contentDescription = stringResource(description_previous_month),
+        )
+        Icon(
+            painter = painterResource(id = R.drawable.ic_arrow_right),
+            modifier =
+                Modifier.clickable(
+                    interactionSource = MutableInteractionSource(),
+                    indication = null,
+                    onClick = onNextMonthClick,
+                ),
+            tint = Gray300,
+            contentDescription = stringResource(description_next_month),
+        )
+    }
+}
+
+@Composable
+fun DayOfWeek(
+    name: String,
+    modifier: Modifier = Modifier,
+) {
+    Text(
+        text = name,
+        modifier = modifier,
+        textAlign = TextAlign.Center,
+        style = HY2Typography().body04,
+        color = Gray300,
+    )
+}
+
+@Preview
+@Composable
+private fun Hy2CalendarPreview() {
+    HY2Theme {
+        val calendar by remember {
+            mutableStateOf(
+                Calendar(
+                    studyDays =
+                        listOf(
+                            StudyDay(
+                                date = LocalDate.now().withDayOfMonth(2),
+                                studyRoomUsage = StudyRoomUsage.USED_ONCE_EXTENDED_ONCE,
+                            ),
+                            StudyDay(
+                                date = LocalDate.now().withDayOfMonth(5),
+                                studyRoomUsage = StudyRoomUsage.USED_ONCE,
+                            ),
+                            StudyDay(
+                                date = LocalDate.now().withDayOfMonth(10),
+                                studyRoomUsage = StudyRoomUsage.USED_ONCE_EXTENDED_TWICE,
+                            ),
+                            StudyDay(
+                                date = LocalDate.now().withDayOfMonth(20),
+                                studyRoomUsage = StudyRoomUsage.NEVER_USED,
+                            ),
+                        ),
+                ),
+            )
+        }
+        var title by remember {
+            mutableStateOf(calendar.now)
+        }
+
+        var month by remember {
+            mutableStateOf(calendar.getMonth())
+        }
+
+        Hy2Calendar(
+            title = title,
+            days = month,
+            onPreviousMonthClick = {
+                calendar.moveToPreviousMonth()
+                title = calendar.now
+                month = calendar.getMonth()
+            },
+            onNextMonthClick = {
+                calendar.moveToNextMonth()
+                title = calendar.now
+                month = calendar.getMonth()
+            },
+        )
+    }
+}
+
+@Preview
+@Composable
+private fun CalendarHeaderPreview() {
+    HY2Theme {
+        CalendarHeader(
+            title = "Jan 2024",
+            onPreviousMonthClick = { },
+            onNextMonthClick = { },
+        )
+    }
+}
+
+@Preview
+@Composable
+private fun DayOfWeekPreview() {
+    HY2Theme {
+        DayOfWeek(name = "Mon")
+    }
+}