From 6e0e14334eb7116aa3d7f08435744e628c6be9e1 Mon Sep 17 00:00:00 2001
From: Nurungjiii <choawon0330@gmail.com>
Date: Mon, 20 Oct 2025 23:15:39 +0900
Subject: [PATCH 1/5] =?UTF-8?q?docs:=20=EA=B5=AC=ED=98=84=ED=95=A0=20?=
 =?UTF-8?q?=EA=B8=B0=EB=8A=A5=20=EB=AA=A9=EB=A1=9D=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 53 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index bd90ef0247..8d88745739 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,53 @@
-# java-calculator-precourse
\ No newline at end of file
+# java-calculator-precourse
+
+## 🚀 구현할 기능 목록
+
+### 1. 문자열 계산기 핵심 기능 (StringCalculator)
+
+#### 1.1. 문자열 유효성 및 초기 처리
+* [ ] 입력 문자열이 `null`이거나 **빈 문자열("")**인지 확인하고 처리한다.
+    * `null` 또는 `""` 입력 시 **`0`**을 반환한다.
+
+#### 1.2. 구분자 결정
+* [ ] 입력 문자열에서 **커스텀 구분자**를 추출한다.
+    * 커스텀 구분자는 문자열 앞부분의 `//`와 `\n` 사이에 위치한 문자여야 한다. (예: `//;\n1;2;3`에서 `;` 추출)
+* [ ] 기본 구분자와 커스텀 구분자를 모두 포함하는 정규 표현식을 구성한다.
+    * **기본 구분자**는 쉼표(`,`) 또는 콜론(`:`)이다.
+
+#### 1.3. 문자열 분리 및 검증
+* [ ] 결정된 구분자를 기준으로 문자열을 분리한다.
+* [ ] 분리된 각 숫자가 **양수**인지 검증한다.
+    * **음수** 포함 시 **`IllegalArgumentException`**을 발생시킨다.
+* [ ] 분리된 각 요소가 **유효한 숫자 형태**인지 검증한다.
+    * 숫자가 아닌 문자(예: `a`) 포함 시 **`IllegalArgumentException`**을 발생시킨다.
+
+#### 1.4. 최종 합산
+* [ ] 분리 및 검증이 완료된 **각 숫자를 합산**한다.
+    * 합산 결과는 정수 형태(int)로 반환한다.
+
+---
+
+### 2. 입출력 및 예외 처리 기능 (Application & Console)
+
+#### 2.1. 입력 처리
+* [ ] 사용자에게 입력을 안내하는 문구를 출력한다.
+    * 출력 문구: `"덧셈할 문자열을 입력해 주세요."`
+* [ ] `Console.readLine()`을 사용하여 사용자로부터 문자열을 입력받는다.
+    * 라이브러리: `camp.nextstep.edu.missionutils.Console` 사용 필수.
+
+#### 2.2. 출력 처리
+* [ ] 계산된 덧셈 결과를 출력한다.
+    * 출력 형식: `"결과 : [계산된 합산 값]"` (예: `결과 : 6`)
+
+#### 2.3. 예외 처리
+* [ ] 계산 로직에서 `IllegalArgumentException`이 발생할 경우 애플리케이션을 종료한다.
+    * 예외 발생 시 **`System.exit()` 호출은 금지**한다.
+
+---
+
+### 3. Git 커밋 및 환경 설정 (Pre-course Requirement)
+
+* [ ] 프로젝트가 **Java 21** 환경에서 실행 가능하도록 확인한다.
+* [ ] 제출 전 모든 테스트 코드를 실행하여 성공 여부를 확인한다.
+    * `.\gradlew.bat clean test` 또는 `./gradlew clean test` 실행 후 **`BUILD SUCCESSFUL`** 확인.
+* [ ] 구현할 기능 목록 단위로 커밋을 진행하며, 커밋 메시지는 **AngularJS Git Commit Message Conventions**을 준수한다.
\ No newline at end of file

From 40d430cb280d5221389c727692e2a1a3a2ce03df Mon Sep 17 00:00:00 2001
From: Nurungjiii <choawon0330@gmail.com>
Date: Mon, 20 Oct 2025 23:21:41 +0900
Subject: [PATCH 2/5] =?UTF-8?q?feat(Calculator):=20=EA=B3=84=EC=82=B0?=
 =?UTF-8?q?=EA=B8=B0=EC=9D=98=20=EB=AC=B8=EC=9E=90=EC=97=B4=20=EB=B6=84?=
 =?UTF-8?q?=EB=A6=AC=20=EA=B8=B0=EB=8A=A5=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/java/calculator/Application.java |  2 +-
 src/main/java/calculator/Calculator.java  | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)
 create mode 100644 src/main/java/calculator/Calculator.java

diff --git a/src/main/java/calculator/Application.java b/src/main/java/calculator/Application.java
index 573580fb40..b9504b80cd 100644
--- a/src/main/java/calculator/Application.java
+++ b/src/main/java/calculator/Application.java
@@ -2,6 +2,6 @@
 
 public class Application {
     public static void main(String[] args) {
-        // TODO: 프로그램 구현
+        Calculator calc = new Calculator("1,2;3");
     }
 }
diff --git a/src/main/java/calculator/Calculator.java b/src/main/java/calculator/Calculator.java
new file mode 100644
index 0000000000..d7d8dd65c2
--- /dev/null
+++ b/src/main/java/calculator/Calculator.java
@@ -0,0 +1,17 @@
+package calculator;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class Calculator {
+
+    private final List<Integer> operands = new ArrayList<>();
+
+    public Calculator(String input) {
+        String[] results = input.split("[,;]");
+
+        for (String element : results) {
+            this.operands.add(Integer.parseInt(element));
+        }
+    }
+}
\ No newline at end of file

From 846f79b0890cbbaad2db3d3c1ede1f39bf119ef4 Mon Sep 17 00:00:00 2001
From: Nurungjiii <choawon0330@gmail.com>
Date: Mon, 20 Oct 2025 23:23:22 +0900
Subject: [PATCH 3/5] =?UTF-8?q?feat(Calculator):=20=EA=B3=84=EC=82=B0?=
 =?UTF-8?q?=EA=B8=B0=EC=9D=98=20=EC=88=AB=EC=9E=90=20=ED=95=A9=EC=B9=98?=
 =?UTF-8?q?=EA=B8=B0=20=EA=B8=B0=EB=8A=A5=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/java/calculator/Application.java | 1 +
 src/main/java/calculator/Calculator.java  | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/src/main/java/calculator/Application.java b/src/main/java/calculator/Application.java
index b9504b80cd..bfe63086f3 100644
--- a/src/main/java/calculator/Application.java
+++ b/src/main/java/calculator/Application.java
@@ -3,5 +3,6 @@
 public class Application {
     public static void main(String[] args) {
         Calculator calc = new Calculator("1,2;3");
+        calc.sum();
     }
 }
diff --git a/src/main/java/calculator/Calculator.java b/src/main/java/calculator/Calculator.java
index d7d8dd65c2..934d310f65 100644
--- a/src/main/java/calculator/Calculator.java
+++ b/src/main/java/calculator/Calculator.java
@@ -14,4 +14,10 @@ public Calculator(String input) {
             this.operands.add(Integer.parseInt(element));
         }
     }
+
+    public int sum() {
+        return operands.stream()
+                .mapToInt(Integer::intValue)
+                .sum();
+    }
 }
\ No newline at end of file

From 832a8312815ff1b03d75bb2c530a6ebcde3555f3 Mon Sep 17 00:00:00 2001
From: Nurungjiii <choawon0330@gmail.com>
Date: Mon, 20 Oct 2025 23:35:31 +0900
Subject: [PATCH 4/5] =?UTF-8?q?feat:=20Operands=20=EC=9D=BC=EA=B8=89?=
 =?UTF-8?q?=EC=BB=AC=EB=A0=89=EC=85=98=EC=9D=84=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/java/calculator/Application.java |  2 +-
 src/main/java/calculator/Calculator.java  | 16 +++++-----------
 src/main/java/calculator/Operand.java     | 19 +++++++++++++++++++
 3 files changed, 25 insertions(+), 12 deletions(-)
 create mode 100644 src/main/java/calculator/Operand.java

diff --git a/src/main/java/calculator/Application.java b/src/main/java/calculator/Application.java
index bfe63086f3..0fa063cc2c 100644
--- a/src/main/java/calculator/Application.java
+++ b/src/main/java/calculator/Application.java
@@ -3,6 +3,6 @@
 public class Application {
     public static void main(String[] args) {
         Calculator calc = new Calculator("1,2;3");
-        calc.sum();
+        System.out.println(calc.sum());
     }
 }
diff --git a/src/main/java/calculator/Calculator.java b/src/main/java/calculator/Calculator.java
index 934d310f65..8a0cc94c00 100644
--- a/src/main/java/calculator/Calculator.java
+++ b/src/main/java/calculator/Calculator.java
@@ -1,23 +1,17 @@
 package calculator;
 
-import java.util.ArrayList;
-import java.util.List;
-
 public class Calculator {
-
-    private final List<Integer> operands = new ArrayList<>();
+    private static final String defaultSeparator = "[,;]";
 
     public Calculator(String input) {
-        String[] results = input.split("[,;]");
+        String[] splitInput = input.split(defaultSeparator);
+        this.operands = new Operands(splitInput);
 
-        for (String element : results) {
-            this.operands.add(Integer.parseInt(element));
-        }
     }
 
     public int sum() {
-        return operands.stream()
-                .mapToInt(Integer::intValue)
+        return operands.getOperands().stream()
+                .mapToInt(Operand::getOperand)
                 .sum();
     }
 }
\ No newline at end of file
diff --git a/src/main/java/calculator/Operand.java b/src/main/java/calculator/Operand.java
new file mode 100644
index 0000000000..c0f8c03aae
--- /dev/null
+++ b/src/main/java/calculator/Operand.java
@@ -0,0 +1,19 @@
+package calculator;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class Operands {
+    private List<Operand> operands = new ArrayList<>();
+
+    public Operands(String[] splitInput) {
+        for (String elem : splitInput) {
+            Operand operand = new Operand(elem);
+            this.operands.add(operand);
+        }
+    }
+
+    public List<Operand> getOperands() {
+        return operands;
+    }
+}
\ No newline at end of file

From f9053dbac10e907924138b9d5090feb12e2a0f4d Mon Sep 17 00:00:00 2001
From: Nurungjiii <choawon0330@gmail.com>
Date: Mon, 20 Oct 2025 23:41:19 +0900
Subject: [PATCH 5/5] =?UTF-8?q?feat:=20Operands=20=EC=9D=BC=EA=B8=89?=
 =?UTF-8?q?=EC=BB=AC=EB=A0=89=EC=85=98=EC=9D=84=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/java/calculator/Operand.java | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/java/calculator/Operand.java b/src/main/java/calculator/Operand.java
index c0f8c03aae..412ac185bf 100644
--- a/src/main/java/calculator/Operand.java
+++ b/src/main/java/calculator/Operand.java
@@ -1,10 +1,10 @@
 package calculator;
 
-import java.util.ArrayList;
-import java.util.List;
 
 public class Operands {
-    private List<Operand> operands = new ArrayList<>();
+    private final static String NOT_STRING_MESSAGE = "숫자가 아닌 문자열이 입력되었습니다.";
+    private final static String NOT_POSITIVE_MESSAGE = "입력된 숫자가 양수가 아닙니다.";
+
 
     public Operands(String[] splitInput) {
         for (String elem : splitInput) {