feature: 사용자 로그인 계정 모델과 저장소 추가

.env.example

@@ -0,0 +1,5 @@
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=momogo
+DB_USERNAME=momogo
+DB_PASSWORD=momogo

README.md

@@ -1 +1,37 @@
-# momogo-server
+# momogo-server
+
+## 패키지 규칙
+
+- `presentation`: Controller를 두고 HTTP 요청과 응답 변환을 담당한다.
+- `application`: Service를 두고 도메인 흐름과 트랜잭션을 담당한다.
+- `domain`: 프레임워크에 의존하지 않는 순수 도메인 객체와 비즈니스 규칙을 둔다.
+- `infrastructure.database.entity`: JPA 매핑 클래스를 두며 이름은 `Entity`로 끝낸다.
+- `infrastructure.database.repository`: Service가 직접 사용하는 Spring Data `Repository`를 둔다.
+- 값 검증은 도메인 객체가 담당하고 JPA Entity에는 비즈니스 로직을 두지 않는다.
+- 의존 흐름은 `Controller → Service → Repository` 순서를 따른다.
+
+## 로컬 PostgreSQL 실행
+
+Docker Compose로 PostgreSQL을 실행한다.
+
+```shell
+docker compose up -d postgres
+```
+
+`local` 프로필로 애플리케이션을 실행한다.
+
+```shell
+./gradlew bootRun --args='--spring.profiles.active=local'
+```
+
+PostgreSQL에 직접 접속할 때는 컨테이너의 `psql`을 사용한다.
+
+```shell
+docker compose exec postgres psql -U momogo -d momogo
+```
+
+종료할 때는 다음 명령을 사용한다. 데이터는 Docker 볼륨에 유지된다.
+
+```shell
+docker compose down
+```

build.gradle

@@ -38,7 +38,7 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
     implementation 'org.jetbrains.kotlin:kotlin-reflect'
     runtimeOnly 'org.postgresql:postgresql'
-    testAndDevelopmentOnly 'com.h2database:h2'
+    testRuntimeOnly 'com.h2database:h2'
     testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
     testImplementation platform('io.kotest:kotest-bom:6.1.5')
     testImplementation 'io.kotest:kotest-runner-junit5'

compose.yaml

@@ -0,0 +1,19 @@
+services:
+  postgres:
+    image: postgres:17-alpine
+    environment:
+      POSTGRES_DB: ${DB_NAME:-momogo}
+      POSTGRES_USER: ${DB_USERNAME:-momogo}
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-momogo}
+    ports:
+      - "${DB_PORT:-5432}:5432"
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  postgres-data:

src/main/kotlin/com/mogumogu/momogo/domain/user/LoginAccount.kt

@@ -0,0 +1,36 @@
+package com.mogumogu.momogo.domain.user
+
+class LoginAccount(
+    val id: Long? = null,
+    val userId: Long,
+    var provider: LoginProvider,
+    providerId: String,
+) {
+    var providerId: String = providerId
+        set(value) {
+            validateProviderId(value)
+            field = value
+        }
+
+    init {
+        validateProviderId(providerId)
+    }
+
+    fun changeProvider(
+        provider: LoginProvider,
+        providerId: String,
+    ) {
+        this.providerId = providerId
+        this.provider = provider
+    }
+
+    private fun validateProviderId(providerId: String) {
+        require(providerId.length <= MAX_PROVIDER_ID_LENGTH) {
+            "로그인 제공자 식별자는 ${MAX_PROVIDER_ID_LENGTH}자 이하여야 합니다."
+        }
+    }
+
+    private companion object {
+        const val MAX_PROVIDER_ID_LENGTH = 255
+    }
+}

src/main/kotlin/com/mogumogu/momogo/domain/user/LoginProvider.kt

@@ -0,0 +1,8 @@
+package com.mogumogu.momogo.domain.user
+
+enum class LoginProvider {
+    GUEST,
+    KAKAO,
+    NAVER,
+    APPLE,
+}

src/main/kotlin/com/mogumogu/momogo/domain/user/User.kt

@@ -0,0 +1,26 @@
+package com.mogumogu.momogo.domain.user
+
+class User(
+    val id: Long? = null,
+    var nickname: String,
+) {
+    init {
+        validateNickname(nickname)
+    }
+
+    fun changeNickname(nickname: String) {
+        validateNickname(nickname)
+        this.nickname = nickname
+    }
+
+    private fun validateNickname(nickname: String) {
+        require(nickname.length in MIN_NICKNAME_LENGTH..MAX_NICKNAME_LENGTH) {
+            "닉네임은 ${MIN_NICKNAME_LENGTH}자 이상 ${MAX_NICKNAME_LENGTH}자 이하여야 합니다."
+        }
+    }
+
+    private companion object {
+        const val MIN_NICKNAME_LENGTH = 1
+        const val MAX_NICKNAME_LENGTH = 12
+    }
+}

src/main/kotlin/com/mogumogu/momogo/infrastructure/database/entity/LoginAccountEntity.kt

@@ -0,0 +1,49 @@
+package com.mogumogu.momogo.infrastructure.database.entity
+
+import com.mogumogu.momogo.domain.user.LoginAccount
+import com.mogumogu.momogo.domain.user.LoginProvider
+import com.mogumogu.momogo.global.entity.BaseEntity
+import jakarta.persistence.Column
+import jakarta.persistence.Entity
+import jakarta.persistence.EnumType
+import jakarta.persistence.Enumerated
+import jakarta.persistence.GeneratedValue
+import jakarta.persistence.GenerationType
+import jakarta.persistence.Id
+import jakarta.persistence.Table
+
+@Entity
+@Table(name = "login_account")
+class LoginAccountEntity(
+    @field:Column(name = "user_id", nullable = false)
+    var userId: Long,
+    @field:Enumerated(EnumType.STRING)
+    @field:Column(name = "provider", nullable = false, length = 20)
+    var provider: LoginProvider,
+    @field:Column(name = "provider_id", nullable = false, length = 255)
+    var providerId: String,
+) : BaseEntity() {
+
+    @field:Id
+    @field:GeneratedValue(strategy = GenerationType.IDENTITY)
+    @field:Column(name = "id", nullable = false, updatable = false)
+    var id: Long? = null
+        protected set
+
+    fun toDomain(): LoginAccount =
+        LoginAccount(
+            id = id,
+            userId = userId,
+            provider = provider,
+            providerId = providerId,
+        )
+
+    companion object {
+        fun fromDomain(loginAccount: LoginAccount): LoginAccountEntity =
+            LoginAccountEntity(
+                userId = loginAccount.userId,
+                provider = loginAccount.provider,
+                providerId = loginAccount.providerId,
+            )
+    }
+}

src/main/kotlin/com/mogumogu/momogo/infrastructure/database/entity/UserEntity.kt

@@ -0,0 +1,35 @@
+package com.mogumogu.momogo.infrastructure.database.entity
+
+import com.mogumogu.momogo.domain.user.User
+import com.mogumogu.momogo.global.entity.BaseEntity
+import jakarta.persistence.Column
+import jakarta.persistence.Entity
+import jakarta.persistence.GeneratedValue
+import jakarta.persistence.GenerationType
+import jakarta.persistence.Id
+import jakarta.persistence.Table
+
+@Entity
+@Table(name = "\"user\"")
+class UserEntity(
+    @field:Column(name = "nickname", nullable = false, length = 12)
+    var nickname: String,
+) : BaseEntity() {
+
+    @field:Id
+    @field:GeneratedValue(strategy = GenerationType.IDENTITY)
+    @field:Column(name = "id", nullable = false, updatable = false)
+    var id: Long? = null
+        protected set
+
+    fun toDomain(): User =
+        User(
+            id = id,
+            nickname = nickname,
+        )
+
+    companion object {
+        fun fromDomain(user: User): UserEntity =
+            UserEntity(nickname = user.nickname)
+    }
+}

src/main/kotlin/com/mogumogu/momogo/infrastructure/database/repository/LoginAccountRepository.kt

@@ -0,0 +1,8 @@
+package com.mogumogu.momogo.infrastructure.database.repository
+
+import com.mogumogu.momogo.infrastructure.database.entity.LoginAccountEntity
+import org.springframework.data.jpa.repository.JpaRepository
+
+interface LoginAccountRepository : JpaRepository<LoginAccountEntity, Long> {
+    fun findAllByUserId(userId: Long): List<LoginAccountEntity>
+}

src/main/kotlin/com/mogumogu/momogo/infrastructure/database/repository/UserRepository.kt

@@ -0,0 +1,6 @@
+package com.mogumogu.momogo.infrastructure.database.repository
+
+import com.mogumogu.momogo.infrastructure.database.entity.UserEntity
+import org.springframework.data.jpa.repository.JpaRepository
+
+interface UserRepository : JpaRepository<UserEntity, Long>

src/main/resources/application-local.yml

@@ -3,17 +3,13 @@ spring:
     activate:
       on-profile: local
   datasource:
-    url: jdbc:h2:mem:momogo;MODE=PostgreSQL;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
-    driver-class-name: org.h2.Driver
-    username: sa
-    password:
-  h2:
-    console:
-      enabled: true
-      path: /h2-console
+    url: jdbc:postgresql://${DB_HOST:localhost}:${DB_PORT:5432}/${DB_NAME:momogo}
+    driver-class-name: org.postgresql.Driver
+    username: ${DB_USERNAME:momogo}
+    password: ${DB_PASSWORD:momogo}
   jpa:
     hibernate:
-      ddl-auto: create-drop
+      ddl-auto: update
     show-sql: true
     properties:
       hibernate: