계좌 이체를 진행한다.

.gitignore

@@ -1,3 +1,154 @@
-.DS_Store
-.idea
+# Created by https://www.toptal.com/developers/gitignore/api/intellij+all,gradle,kotlin
+# Edit at https://www.toptal.com/developers/gitignore?templates=intellij+all,gradle,kotlin
+
+### Intellij+all ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### Intellij+all Patch ###
+# Ignore everything but code style settings and run configurations
+# that are supposed to be shared within teams.
+
+.idea/*
+
+!.idea/codeStyles
+!.idea/runConfigurations
+
+### Kotlin ###
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+replay_pid*
+
+### Gradle ###
 .gradle
+**/build/
+!src/**/build/
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
+!gradle-wrapper.jar
+
+# Avoid ignore Gradle wrappper properties
+!gradle-wrapper.properties
+
+# Cache of project
+.gradletasknamecache
+
+# Eclipse Gradle plugin generated files
+# Eclipse Core
+.project
+# JDT-specific (Eclipse Java Development Tools)
+.classpath
+
+### Gradle Patch ###
+# Java heap dump
+*.hprof
+
+# Fixture Monkey
+
+.jqwik-database
+
+# out package exclusion
+
+!src/main/kotlin/com/example/estdelivery/application/port/out
+!src/test/kotlin/com/example/estdelivery/application/port/out
+
+# End of https://www.toptal.com/developers/gitignore/api/intellij+all,gradle,kotlin

README.md

@@ -1,13 +1,183 @@
-# 2주차 
+# 2주차
+
 ## 이츠 페이먼츠 ( EST's-Payments )
-이스트소프트는 최근 금융사업과 관련하여 송금 서비스를 제공하기로 결정되었다. 각 서비스들은 MSA로 분리되어있다. 
-<br> 
 
-베타서비스를 위해, A2개발팀은 송금과 관련된 요구사항이 부여되었고 개발자들은 해당 요구사항을 토대로 개발을 진행해야한다. 
+이스트소프트는 최근 금융사업과 관련하여 송금 서비스를 제공하기로 결정되었다. 각 서비스들은 MSA로 분리되어있다.
+<br>
+
+베타서비스를 위해, A2개발팀은 송금과 관련된 요구사항이 부여되었고 개발자들은 해당 요구사항을 토대로 개발을 진행해야한다.
+
+## 요구사항
 
-## 요구사항 
 1. 사용자는 돈이 없으면 송금할 수 없다.
 2. 동일한 송금은 두번 요청할 수 없다.
 3. 송금 후에는 계좌잔액을 노출해야 한다.
 4. 송금 내역은 5개월동안 보장되고 그 이후의 내역은 삭제되어야 한다.
 
+> 송금 이력이 사라지기 때문에 계좌 잔액을 영속화하거나 송금 기록을 제외한 입출금 내역만을 관리해 계좌 잔액을 계산해야 한다.
+
+## 요구사항 정제
+
+- `계좌 번호`를 입력해 `계좌`를 생성한다.
+    - `계좌 번호`는 10자리로 구성되어있다.
+    - `계좌 번호`는 중복되어서는 안된다.
+- `자신 계좌 번호`와 `상대방 계좌 번호` 그리고 `돈의 수량`을 입력해 송금을 진행 한 후 계좌 잔액을 노출한다.
+    - `상대방 계좌 번호`가 존재하지 않으면 안된다.
+    - `자신 계좌 번호`가 존재하지 않으면 안된다.
+    - `자신 계좌 번호`와 `상대방 계좌 번호`가 동일하면 안된다.
+    - `돈의 수량`은 0보다 커야한다.
+    - `자신 계좌`에 잔액이 입력한 `돈의 수량`보다 많아야 한다.
+    - 동일한 송금은 두번 요청할 수 없다.
+    - `자신 계좌`에서 `상대방의 계좌`로 돈을 전달한다.
+    - 송금한 기록을 남긴다. 송금 기록에는 `자신의 계좌 번호`, `상대방 계좌 번호`, `송금한 돈의 수량`, `송금한 일자`가 포함된다.
+    - 송금 후 `자신 계좌` 잔액을 노출한다.
+- `계좌 번호`, `돈의 수량`를 입력해 돈을 입급한다.
+    - `계좌 번호`가 존재하지 않으면 안된다.
+    - `돈의 수량`은 0보다 커야한다.
+- `계좌 번호`, `돈의 수량`를 입력해 돈을 출금한다.
+    - `계좌 번호`가 존재하지 않으면 안된다.
+    - `돈의 수량`은 0보다 커야한다.
+    - `계좌`에 잔액이 입력한 `돈의 수량`보다 많아야 한다.
+
+## 모델링
+
+| 한글        | 영어                 | 설명                                                              |
+|-----------|--------------------|-----------------------------------------------------------------|
+| 송금        | Transfer           | 송금에는 `송금한 계좌`, `송금받은 계좌`, `송금한 돈의 수량`, `송금한 일자`가 포함된다.          |
+| 송금한 계좌    | sourceAccount      | 송금하려는 계좌 정보.                                                    |
+| 송금받은 계좌   | targetAccount      | 송금받는 계좌 정보.                                                     |
+| 송금한 돈의 수량 | transferMoney      | 송금할 돈의 수량.                                                      |
+| 송금한 일자    | transferDate       | 송금한 일자는 송금한 날짜.                                                 |
+| 계좌        | Account            | 계좌에는 `계좌 번호`, `생성 일자 정보`, `잔액 정보`, `송금 이력`을 포함한다.               |
+| 계좌 번호     | AccountNumber      | 10자리로 구성된 고유한 값.                                                |
+| 생성 일자     | createDate         | 계좌를 생성한 날짜.                                                     |
+| 잔액        | balance            | 계좌에 남은 돈의 수량.                                                   |
+| 송금 이력     | transferHistories  | 송금 이력에는 `송금한 계좌 번호`, `송금받은 계좌 번호`, `송금한 돈의 수량`, `송금한 일자`가 포함된다. |
+| 돈         | Money              | 주고받는 돈의 기본 단위. 돈의 수량은 0 이상이어야 한다.                               |
+| 입출금 이력    | transactionHistory | 입출금 이력에는 `계좌 번호`, `입출금 타입`, `돈의 수량`, `입출금 일자`가 포함된다.            |
+
+### 입금
+
+- `계좌 번호(AccountNumber)`와 `돈의 수량(Money)`을 입력해 돈을 입금한다.
+- `계좌 번호(AccountNumber)`가 존재하지 않으면 안된다.
+- `돈의 수량(Money)`은 0보다 커야한다.
+- `입출금 이력(transactionHisotry)`에 `입금 기록(DEPOSIT)`을 추가한다.
+
+### 출금
+
+- `계좌 번호(AccountNumber)`와 `돈의 수량(Money)`을 입력해 돈을 출금한다.
+- `계좌 번호(AccountNumber)`가 존재하지 않으면 안된다.
+- `돈의 수량(Money)`은 0보다 커야한다.
+- `계좌`에 잔액이 입력한 `돈의 수량(Money)`보다 많아야 한다.
+- `입출금 이력(transactionHisotry)`에 `출금 기록(WITHDRAW)`을 추가한다.
+
+### 송금
+
+- `자신 계좌(sourceAccount)`와 `상대방 계좌(targetAccount)`, `송금 일자(transferDate)` 그리고 `돈의 수량(transferMoney)`을 입력해 송금한다.
+- `상대방 계좌(targetAccount)`가 존재하지 않으면 안된다.
+- `자신 계좌(sourceAccount)`가 존재하지 않으면 안된다.
+- `자신 계좌(sourceAccount)`와 `상대방 계좌(targetAccount)`가 동일하면 안된다.
+- `돈의 수량(transferMoney)`은 0보다 커야한다.
+- `자신 계좌(sourceAccount)`의 `입출금 이력(transactionHisotry)`에는 `출금 기록(WITHDRAW)`을 추가한다.
+- `상대방 계좌(targetAccount)`의 `입출금 이력(transactionHisotry)`에는 `입금 기록(DEPOSIT)`을 추가한다.
+
+### 계좌
+
+- 계좌에는 `계좌 번호(AccountNumber)`, `생성 일자 정보(createDate)`, `잔액 정보(balance)`, `송금 이력(transferHistories)`, `입출금 이력(transactionHisotry)`를 포함한다.
+- `입출금 이력(transactionHisotry)` 에는 `계좌 번호(AccountNumber)`, `입출금 타입(type)`, `돈의 수량(Money)`, `입출금 일자(transactionDate)`가 포함된다.
+- `입출금 이력(transactionHisotry)`으로 `잔액 정보(balance)`를 계산한다.
+- `계좌 번호(AccountNumber)`는 10자리로 구성되어있다.
+- `잔액 정보(balance)`는 0 이상이어야 한다.
+- `송금 이력(transferHistories)` 에는 `송금한 계좌(sourceAccountNumber)`, `송금받은 계좌(targetAccountNumber)`, `송금한 돈의 수량(transferMoney)`, `송금한 일자(transferDate)`가 포함된다.
+
+### 돈(Money)
+
+- `금액 정보(amount)`가 포함된다.
+
+### 클래스 다이어그램
+
+```mermaid
+classDiagram
+    class Withdraw {
+        - Account targetAccount
+        - Money withdrawMoney
+        - Date withdrawDate
+    }
+
+    class Deposit {
+        - Account targetAccount
+        - Money depositMoney
+        - Date depositDate
+    }
+
+    class Transfer {
+        - Account sourceAccount
+        - Account targetAccount
+        - money transferMoney
+        - Date transferDate
+    }
+
+    class Account {
+        - AccountNumber number
+        - Money balance
+        - List~TransferHistory~ transferHistories
+        - Date createdDate
+    }
+
+    class AccountNumber {
+        - String number
+    }
+
+    class TransferHistory {
+        - AccountNumber sourceAccountNumber
+        - AccountNumber targetAccountNumber
+        - Money transferMoney
+        - TransferDate transferDate
+    }
+
+    class Money {
+        - int amount
+    }
+
+    Withdraw *-- Account
+    Withdraw *-- Money
+    Deposit *-- Account
+    Deposit *-- Money
+    Account *-- AccountNumber
+    Account *-- Money
+    Account *-- TransferHistory
+    Transfer *-- Money
+    Transfer *-- Account
+    TransferHistory *-- Money
+    TransferHistory *-- AccountNumber
+```
+
+## erd
+
+```mermaid
+erDiagram
+    transfer_history {
+      id long pk
+      source_account_number varchar(200)
+      target_account_number varchar(200)
+      transfer_money int
+      trasfer_date date
+    }
+
+    account {
+      id long pk
+      account_number varchar(200)
+      created_date date
+     }
+
+    account_transaction {
+      id long pk
+      account_id long fk
+      type enum "WITHDRAW, DEPOSIT"
+      money int
+      transaction_date date
+    }
+
+    account ||--o{ transfer_history: has
+    account ||--o{ account_transaction: contains
+```

build.gradle.kts

@@ -24,12 +24,16 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-web")
     implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
     implementation("org.jetbrains.kotlin:kotlin-reflect")
+    implementation("org.springframework.boot:spring-boot-starter-validation")
     runtimeOnly("com.h2database:h2")
 
     testImplementation("org.springframework.boot:spring-boot-starter-test")
     testImplementation("org.junit.jupiter", "junit-jupiter", "5.8.2")
     testImplementation("org.assertj", "assertj-core", "3.22.0")
     testImplementation("io.kotest", "kotest-runner-junit5", "5.4.0")
+    testImplementation("com.navercorp.fixturemonkey:fixture-monkey-starter-kotlin:1.0.13")
+    testImplementation("com.navercorp.fixturemonkey:fixture-monkey-jakarta-validation:1.0.0")
+    testImplementation("io.mockk:mockk:1.13.9")
 }
 
 tasks.withType<KotlinCompile> {

src/main/kotlin/com/example/estdelivery/application/CreateAccountService.kt

@@ -0,0 +1,27 @@
+package com.example.estdelivery.application
+
+import com.example.estdelivery.application.port.`in`.CreateAccountUseCase
+import com.example.estdelivery.application.port.`in`.command.CreateAccountCommand
+import com.example.estdelivery.application.port.out.CreateAccountPort
+import com.example.estdelivery.application.port.out.GenerateAccountNumberPort
+import com.example.estdelivery.domain.Account
+import com.example.estdelivery.domain.AccountTransactions
+import com.example.estdelivery.domain.TransferHistories
+import org.springframework.stereotype.Service
+
+@Service
+class CreateAccountService(
+    private val createAccountPort: CreateAccountPort,
+    private val generateAccountNumber: GenerateAccountNumberPort,
+) : CreateAccountUseCase {
+    /**
+     * 1. 계좌를 생성한다.
+     * 2. 계좌 정보를 저장한다.
+     */
+    override fun createAccount(command: CreateAccountCommand) {
+        val accountNumber = generateAccountNumber.generate()
+        val newAccount =
+            Account(accountNumber, TransferHistories(), AccountTransactions(), command.createTime)
+        createAccountPort.create(newAccount)
+    }
+}