From c0dcfd8aa69e2c7e316fd19b2c35527541e59906 Mon Sep 17 00:00:00 2001
From: "hanyoung.park" <hanyoung.park@kurlycorp.com>
Date: Mon, 2 Feb 2026 01:26:59 +0900
Subject: [PATCH 01/29] remove: deprecated codeguide

---
 .codeguide/loopers-1-week.md | 45 ------------------------------------
 1 file changed, 45 deletions(-)
 delete mode 100644 .codeguide/loopers-1-week.md

diff --git a/.codeguide/loopers-1-week.md b/.codeguide/loopers-1-week.md
deleted file mode 100644
index a8ace53e..00000000
--- a/.codeguide/loopers-1-week.md
+++ /dev/null
@@ -1,45 +0,0 @@
-## 🧪 Implementation Quest
-
-> 지정된 **단위 테스트 / 통합 테스트 / E2E 테스트 케이스**를 필수로 구현하고, 모든 테스트를 통과시키는 것을 목표로 합니다.
-
-### 회원 가입
-
-**🧱 단위 테스트**
-
-- [ ]  ID 가 `영문 및 숫자 10자 이내` 형식에 맞지 않으면, User 객체 생성에 실패한다.
-- [ ]  이메일이 `xx@yy.zz` 형식에 맞지 않으면, User 객체 생성에 실패한다.
-- [ ]  생년월일이 `yyyy-MM-dd` 형식에 맞지 않으면, User 객체 생성에 실패한다.
-
-**🔗 통합 테스트**
-
-- [ ]  회원 가입시 User 저장이 수행된다. ( spy 검증 )
-- [ ]  이미 가입된 ID 로 회원가입 시도 시, 실패한다.
-
-**🌐 E2E 테스트**
-
-- [ ]  회원 가입이 성공할 경우, 생성된 유저 정보를 응답으로 반환한다.
-- [ ]  회원 가입 시에 성별이 없을 경우, `400 Bad Request` 응답을 반환한다.
-
-### 내 정보 조회
-
-**🔗 통합 테스트**
-
-- [ ]  해당 ID 의 회원이 존재할 경우, 회원 정보가 반환된다.
-- [ ]  해당 ID 의 회원이 존재하지 않을 경우, null 이 반환된다.
-
-**🌐 E2E 테스트**
-
-- [ ]  내 정보 조회에 성공할 경우, 해당하는 유저 정보를 응답으로 반환한다.
-- [ ]  존재하지 않는 ID 로 조회할 경우, `404 Not Found` 응답을 반환한다.
-
-### 포인트 조회
-
-**🔗 통합 테스트**
-
-- [ ]  해당 ID 의 회원이 존재할 경우, 보유 포인트가 반환된다.
-- [ ]  해당 ID 의 회원이 존재하지 않을 경우, null 이 반환된다.
-
-**🌐 E2E 테스트**
-
-- [ ]  포인트 조회에 성공할 경우, 보유 포인트를 응답으로 반환한다.
-- [ ]  `X-USER-ID` 헤더가 없을 경우, `400 Bad Request` 응답을 반환한다.

From c49eec329bf144e5559564e9079f0a8a383f5f7f Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Tue, 3 Feb 2026 15:44:43 +0900
Subject: [PATCH 02/29] =?UTF-8?q?chore:=20gitignore=20=EB=82=B4=EC=9A=A9?=
 =?UTF-8?q?=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.gitignore b/.gitignore
index 5a979af6..88ce09aa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -38,3 +38,9 @@ out/
 
 ### Kotlin ###
 .kotlin
+
+### Claude Code ###
+.claude/
+
+### Documentation ###
+docs/

From aa462f9348025b693e5faf922cfdd8d373499f89 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Tue, 3 Feb 2026 16:38:48 +0900
Subject: [PATCH 03/29] =?UTF-8?q?docs:=20=EC=98=A8=EB=B3=B4=EB=94=A9=20?=
 =?UTF-8?q?=EA=B6=81=EA=B8=88=EC=A6=9D=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md   | 77 +++++++++++++++++++++++++++++------------------------
 ToDoList.md | 32 ++++++++++++++++++++++
 2 files changed, 74 insertions(+), 35 deletions(-)
 create mode 100644 ToDoList.md

diff --git a/README.md b/README.md
index f86e4dd8..30d2f701 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,47 @@
-# Loopers Template (Spring + Java)
-Loopers 에서 제공하는 스프링 자바 템플릿 프로젝트입니다.
-
-## Getting Started
-현재 프로젝트 안정성 및 유지보수성 등을 위해 아래와 같은 장치를 운용하고 있습니다. 이에 아래 명령어를 통해 프로젝트의 기반을 설치해주세요.
-### Environment
-`local` 프로필로 동작할 수 있도록, 필요 인프라를 `docker-compose` 로 제공합니다.
-```shell
-docker-compose -f ./docker/infra-compose.yml up
+# Round-1  목표
 ```
-### Monitoring
-`local` 환경에서 모니터링을 할 수 있도록, `docker-compose` 를 통해 `prometheus` 와 `grafana` 를 제공합니다.
-
-애플리케이션 실행 이후, **http://localhost:3000** 로 접속해, admin/admin 계정으로 로그인하여 확인하실 수 있습니다.
-```shell
-docker-compose -f ./docker/monitoring-compose.yml up
+- 나의 의도를 테스트 코드로 작성한다.
+- TDD 방식으로 AI와 함께 기능 구현해본다. 
+- TDD로 요구사항을 먼저 정리하는 장점을 느껴본다.
+- 작게 쪼개고 점진적으로 설계하는 과정을 느껴본다.
+- 리팩토링이 가능하다는것을 느껴본다. 
 ```
 
-## About Multi-Module Project
-본 프로젝트는 멀티 모듈 프로젝트로 구성되어 있습니다. 각 모듈의 위계 및 역할을 분명히 하고, 아래와 같은 규칙을 적용합니다.
+##  1. 시작전, 궁금증들 
 
-- apps : 각 모듈은 실행가능한 **SpringBootApplication** 을 의미합니다.
-- modules : 특정 구현이나 도메인에 의존적이지 않고, reusable 한 configuration 을 원칙으로 합니다.
-- supports : logging, monitoring 과 같이 부가적인 기능을 지원하는 add-on 모듈입니다.
+### 1. 목표를 세우며
+- 이 과정에서 나는 테스트 가능한 구조가 무엇인지 체감할 수 있을까?
+    - 어느 과정에서 테스트 가능한 구조라고 느꼈을까?
 
-```
-Root
-├── apps ( spring-applications )
-│   ├── 📦 commerce-api
-│   ├── 📦 commerce-batch
-│   └── 📦 commerce-streamer
-├── modules ( reusable-configurations )
-│   ├── 📦 jpa
-│   ├── 📦 redis
-│   └── 📦 kafka
-└── supports ( add-ons )
-    ├── 📦 jackson
-    ├── 📦 monitoring
-    └── 📦 logging
-```
+### 2. 멀티모듈 
+- 멀티모듈? 이게 뭐지? 왜 이 구조로 나눴어야 했지?
+- 각 모듈의 네이밍에는 -api , -batch, - streamer 라고 붙여져 있는데 왜 이렇게 붙인거지?
+
+
+### 3. 모듈 아키텍처(commerce-api)
+- 왜 Controller 패키지명이 아닌, interfaces라고 하지? 지금은 컨트롤러 하나 뿐인데? 확장성을 위해 먼저 이렇게 네이밍 짓는게 유리한가?
+- 계층간 DTO의 네이밍은 어떻게 지어야할까?
+- DTO를 내부클래스로 관리하고 있네? 파일 수를 줄이기 위함인가? 왜 이렇게 한거지? 이게 현업 방식인가?
+- 왜 온보딩 프로젝트에 JPA를 사용한거지? 쉽고 다들 사용하니까?
+
+
+## 2. Round1 문서를 읽으며,  알게된 부분
+
+### 1. 테스트 코드 및 더블 
+- 나는 테스트 레이어별 어떤 기술들을 사용해야하는지 잘 모른다.
+- 테스트 작성 시, 레이어별 테스트 기술들에 익숙해지도록한다.
+- Mock(대역 객체)를 의미한다. 이 기술을 잘 모른다.
+
+
+### 2. 테스트 더블
+- Mock(대역 객체)를 의미한다. 이 기술을 잘 모른다.
+- 테스트 더블 사용 원칙 및 익숙해지도록 집중한다.
+
+### 3. TDD 가능한 구조의 특징
+- 가장 걱정되는건 비즈니스 로직 분리에서 어떤 기준으로 도메인 엔티티쪽에 로직을 둘지, 서비스에 둘지 판단하는 기준
+
+---
+
+## 📋 기능 요구 사항
+
+기능 요구 사항 정리 [ToDoList.md](./ToDoList.md)
diff --git a/ToDoList.md b/ToDoList.md
new file mode 100644
index 00000000..f6a92673
--- /dev/null
+++ b/ToDoList.md
@@ -0,0 +1,32 @@
+# 기능 요구 사항
+
+
+### 1. 회원가입
+- **필요 정보 : { 로그인 ID, 비밀번호, 이름, 생년월일, 이메일 }**
+- 이미 가입된 로그인 ID 로는 가입이 불가능함
+- 각 정보는 포맷에 맞는 검증 필요 (이름, 이메일, 생년월일)
+- 비밀번호는 암호화해 저장하며, 아래와 같은 규칙을 따름
+```
+1. 8~16자의 영문 대소문자, 숫자, 특수문자만 가능합니다.
+2. 생년월일은 비밀번호 내에 포함될 수 없습니다.
+```
+> 이후, 유저 정보가 필요한 모든 요청은 아래 헤더를 통해 요청
+> * X-Loopers-LoginId : 로그인 ID
+> * X-Loopers-LoginPw : 비밀번호
+
+
+### 2. 내 정보 조회
+- **반환 정보 : { 로그인 ID, 이름, 생년월일, 이메일 }**
+- 로그인 ID 는 영문과 숫자만 허용
+- 이름은 마지막 글자를 마스킹해 반환
+
+> 마스킹 문자는 `*` 로 통일
+>
+
+### 3. 비밀번호 수정
+- **필요 정보 : { 기존 비밀번호, 새 비밀번호 }**
+- 비밀 번호 RULE 을 따르되, 현재 비밀번호는 사용할 수 없습니다.
+
+> **비밀번호 RULE**
+> * 영문 대/소문자, 숫자, 특수문자 사용 가능
+> * 생년월일 사용 불가

From d105efbe62c41daf99c792a0efb239a5e591629f Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 18:30:13 +0900
Subject: [PATCH 04/29] =?UTF-8?q?feat:=20=EC=9C=A0=EC=A0=80=20=EB=AA=A8?=
 =?UTF-8?q?=EB=8D=B8=20=EC=83=9D=EC=84=B1=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/com/loopers/domain/BirthDate.java    | 32 ++++++
 .../main/java/com/loopers/domain/Email.java   | 36 +++++++
 .../main/java/com/loopers/domain/LoginId.java |  7 ++
 .../main/java/com/loopers/domain/Name.java    |  7 ++
 .../java/com/loopers/domain/Password.java     | 20 ++++
 .../java/com/loopers/domain/UserModel.java    | 65 ++++++++++++
 .../com/loopers/domain/UserModelTest.java     | 98 +++++++++++++++++++
 7 files changed, 265 insertions(+)
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/Email.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/Name.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/Password.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
new file mode 100644
index 00000000..d51da66c
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
@@ -0,0 +1,32 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+
+public class BirthDate {
+    private final LocalDate birthDate;
+
+    public BirthDate(LocalDate birthDate) {
+        validate(birthDate);
+        this.birthDate = birthDate;
+    }
+
+    private void validate(LocalDate birthDate) {
+        if (birthDate == null) {
+            throw new CoreException(ErrorType.BAD_REQUEST,"생년월일은 필수 입력값입니다.");
+        }
+        if (birthDate.isAfter(LocalDate.now())) {
+            throw new CoreException(ErrorType.BAD_REQUEST,"생년월일은 과거 날짜여야 합니다.");
+        }
+    }
+
+    public String toDateString() {
+        return birthDate.format(DateTimeFormatter.ofPattern("yyyyMMdd"));
+    }
+
+    public LocalDate getDate() {
+        return birthDate;
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Email.java b/apps/commerce-api/src/main/java/com/loopers/domain/Email.java
new file mode 100644
index 00000000..71ea1a7a
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Email.java
@@ -0,0 +1,36 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embeddable;
+import java.util.regex.Pattern;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+
+@Embeddable
+@Getter
+@EqualsAndHashCode
+public class Email {
+    private static final Pattern EMAIL_PATTERN = Pattern.compile(
+            "^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$"
+    );
+
+    private String mail;
+
+    protected Email() {}
+
+    public Email(String mail) {
+        validateEmail(mail);
+        this.mail = mail;
+    }
+
+    private void validateEmail(String mail) {
+        if (mail == null || mail.isBlank()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "이메일은 비어있을 수 없습니다.");
+        }
+
+        if (!EMAIL_PATTERN.matcher(mail).matches()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "이메일 형식이 올바르지 않습니다.");
+        }
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
new file mode 100644
index 00000000..d959fead
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
@@ -0,0 +1,7 @@
+package com.loopers.domain;
+
+public class LoginId {
+    public LoginId(String testuser123) {
+
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
new file mode 100644
index 00000000..91bbad9e
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
@@ -0,0 +1,7 @@
+package com.loopers.domain;
+
+public class Name {
+    public Name(String 홍길동) {
+
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
new file mode 100644
index 00000000..7a23c236
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
@@ -0,0 +1,20 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+
+public class Password {
+    private final String password;
+
+    public Password(String password) {
+        this.password = password;
+    }
+
+    public void validateNotContainBirthday(BirthDate birthDate) {
+        String targetDate = birthDate.toDateString();
+
+        if (this.password.contains(targetDate)) {
+            throw new CoreException(ErrorType.BAD_REQUEST,"생년월일은 비밀번호 내에 포함될 수 없습니다");
+        }
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
new file mode 100644
index 00000000..a4e79160
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
@@ -0,0 +1,65 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embedded;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@Table(name = "users")
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+public class UserModel extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Embedded
+    private LoginId loginId;
+
+    @Embedded
+    private Password password;
+
+    @Embedded
+    private Name name;
+
+    @Embedded
+    private BirthDate birthDate;
+
+    @Embedded
+    private Email email;
+
+    public UserModel(LoginId loginId, Password password, Name name, BirthDate birthDate, Email email) {
+        validate(loginId, password, name, birthDate, email);
+        this.loginId = loginId;
+        this.password = password;
+        this.name = name;
+        this.birthDate = birthDate;
+        this.email = email;
+    }
+
+    private void validate(LoginId loginId, Password password, Name name, BirthDate birthDate, Email email) {
+        validateNotNull(loginId, "로그인 ID");
+        validateNotNull(password, "비밀번호");
+        validateNotNull(name, "이름");
+        validateNotNull(birthDate, "생년월일");
+        validateNotNull(email, "이메일");
+
+        password.validateNotContainBirthday(birthDate);
+    }
+    private void validateNotNull(Object value, String fieldName) {
+        if (value == null) {
+            throw new CoreException(ErrorType.BAD_REQUEST,fieldName + "은(는) 필수 입력값입니다.");
+        }
+    }
+}
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
new file mode 100644
index 00000000..eaf9ea6f
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
@@ -0,0 +1,98 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.junit.jupiter.api.Assertions.assertAll;
+
+import com.loopers.support.error.CoreException;
+import java.time.LocalDate;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+
+class UserModelTest {
+
+    private LoginId validLoginId;
+    private Password validPassword;
+    private Name validName;
+    private BirthDate validBirthDate;
+    private Email validEmail;
+
+    @BeforeEach
+    void setUp() {
+        validLoginId = new LoginId("testuser123");
+        validPassword = new Password("Test1234!@#");
+        validName = new Name("홍길동");
+        validBirthDate = new BirthDate(LocalDate.of(1990, 1, 15));
+        validEmail = new Email("test@example.com");
+    }
+
+    @DisplayName("유저 모델을 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("모든 필드가 주어지면, 정상적으로 생성된다.")
+        @Test
+        void createUserModel_whenAllDataProvided() {
+            // act
+            UserModel user = new UserModel(validLoginId, validPassword, validName, validBirthDate, validEmail);
+
+            // assert
+            assertAll(
+                    () -> assertThat(user.getLoginId()).isEqualTo(validLoginId),
+                    () -> assertThat(user.getPassword()).isEqualTo(validPassword),
+                    () -> assertThat(user.getName()).isEqualTo(validName),
+                    () -> assertThat(user.getBirthDate()).isEqualTo(validBirthDate),
+                    () -> assertThat(user.getEmail()).isEqualTo(validEmail)
+            );
+        }
+
+        @DisplayName("로그인 ID가 누락되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenLoginIdIsNull() {
+            assertThatThrownBy(() -> new UserModel(null, validPassword, validName, validBirthDate, validEmail))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("비밀번호가 누락되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenPasswordIsNull() {
+            assertThatThrownBy(() -> new UserModel(validLoginId, null, validName, validBirthDate, validEmail))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("이름이 누락되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenNameIsNull() {
+            assertThatThrownBy(() -> new UserModel(validLoginId, validPassword, null, validBirthDate, validEmail))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("생년월일이 누락되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenBirthDateIsNull() {
+            assertThatThrownBy(() -> new UserModel(validLoginId, validPassword, validName, null, validEmail))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("이메일이 누락되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenEmailIsNull() {
+            assertThatThrownBy(() -> new UserModel(validLoginId, validPassword, validName, validBirthDate, null))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("비밀번호에 생년월일이 포함되면 예외가 발생한다.")
+        @Test
+        void createUserModel_whenPasswordContainsBirthDate() {
+            // arrange
+            BirthDate birthDate = new BirthDate(LocalDate.of(1990, 1, 15));
+            Password passwordWithBirthDate = new Password("pw19900115!");
+
+            // expect
+            assertThatThrownBy(() -> new UserModel(validLoginId, passwordWithBirthDate, validName, birthDate, validEmail))
+                    .isInstanceOf(CoreException.class);
+        }
+    }
+}

From 8dd32ec67c18efe54be17b26e54b60691819b9bd Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 19:29:29 +0900
Subject: [PATCH 05/29] =?UTF-8?q?feat:=20=EC=9C=A0=EC=A0=80=20=EC=9D=B4?=
 =?UTF-8?q?=EB=A6=84=20=EC=83=9D=EC=84=B1=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/com/loopers/domain/Name.java    | 19 +++++-
 .../java/com/loopers/domain/NameTest.java     | 62 +++++++++++++++++++
 2 files changed, 80 insertions(+), 1 deletion(-)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
index 91bbad9e..69ba5bb2 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
@@ -1,7 +1,24 @@
 package com.loopers.domain;
 
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+
 public class Name {
-    public Name(String 홍길동) {
+    private final static int MIN_LENGTH = 2;
+    private final static int MAX_LENGTH = 10;
+    private final String name;
+
+    public Name(String name) {
+        validate(name);
+        this.name = name;
+    }
 
+    private void validate(String name) {
+        if (name == null || name.isBlank()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "이름은 비어있을 수 없습니다.");
+        }
+        if(name.length() < MIN_LENGTH ||  name.length() > MAX_LENGTH){
+            throw new CoreException(ErrorType.BAD_REQUEST, "유효하지 않은 이름 길이입니다.");
+        }
     }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java
new file mode 100644
index 00000000..4fb93454
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java
@@ -0,0 +1,62 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import com.loopers.support.error.CoreException;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
+
+class NameTest {
+
+    @DisplayName("이름 객체를 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("2자 이상 10자 이하의 이름이 주어지면, 정상적으로 생성된다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"홍길", "홍길동", "가나다라마바사아자차"})
+        void createName_whenValidNameProvided(String validNameValue) {
+            // act
+            Name name = new Name(validNameValue);
+
+            // assert
+            assertThat(name).isNotNull();
+        }
+
+        @DisplayName("이름이 null이면 예외가 발생한다.")
+        @Test
+        void createName_whenNameIsNull() {
+            assertThatThrownBy(() -> new Name(null))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("이름이 빈 문자열이거나 공백이면 예외가 발생한다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"", " ", "   "})
+        void createName_whenNameIsBlank(String blankName) {
+            assertThatThrownBy(() -> new Name(blankName))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("이름이 2자 미만이면 예외가 발생한다.")
+        @Test
+        void createName_whenNameIsTooShort() {
+            String shortName = "가";
+
+            assertThatThrownBy(() -> new Name(shortName))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("이름이 10자를 초과하면 예외가 발생한다.")
+        @Test
+        void createName_whenNameIsTooLong() {
+            String longName = "가나다라마바사아자차카"; // 11자
+
+            assertThatThrownBy(() -> new Name(longName))
+                    .isInstanceOf(CoreException.class);}
+    }
+}

From 1069a2d0f322836559c7d01d97167058f179a4c5 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 19:36:01 +0900
Subject: [PATCH 06/29] =?UTF-8?q?feat:=20=EC=83=9D=EB=85=84=EC=9B=94?=
 =?UTF-8?q?=EC=9D=BC=20=EC=83=9D=EC=84=B1=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/com/loopers/domain/BirthDate.java    |  6 +-
 .../com/loopers/domain/BirthDateTest.java     | 69 +++++++++++++++++++
 2 files changed, 73 insertions(+), 2 deletions(-)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/BirthDateTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
index d51da66c..6f88bc17 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
@@ -6,6 +6,9 @@
 import java.time.format.DateTimeFormatter;
 
 public class BirthDate {
+
+    private static final DateTimeFormatter DATE_STRING_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
+
     private final LocalDate birthDate;
 
     public BirthDate(LocalDate birthDate) {
@@ -23,8 +26,7 @@ private void validate(LocalDate birthDate) {
     }
 
     public String toDateString() {
-        return birthDate.format(DateTimeFormatter.ofPattern("yyyyMMdd"));
-    }
+        return birthDate.format(DATE_STRING_FORMATTER);    }
 
     public LocalDate getDate() {
         return birthDate;
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/BirthDateTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/BirthDateTest.java
new file mode 100644
index 00000000..cb3c0304
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/BirthDateTest.java
@@ -0,0 +1,69 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import com.loopers.support.error.CoreException;
+import java.time.LocalDate;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+
+class BirthDateTest {
+
+    @DisplayName("생년월일 객체를 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("과거 혹은 현재의 날짜가 주어지면, 정상적으로 생성된다.")
+        @Test
+        void createBirthDate_whenValidDateProvided() {
+            // arrange
+            LocalDate validDate = LocalDate.of(1995, 5, 20);
+
+            // act
+            BirthDate birthDate = new BirthDate(validDate);
+
+            // assert
+            assertThat(birthDate.getDate()).isEqualTo(validDate);
+        }
+
+        @DisplayName("날짜가 null이면 예외가 발생한다.")
+        @Test
+        void createBirthDate_whenDateIsNull() {
+            assertThatThrownBy(() -> new BirthDate(null))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("필수 입력값입니다.");
+        }
+
+        @DisplayName("날짜가 미래의 날짜이면 예외가 발생한다.")
+        @Test
+        void createBirthDate_whenDateIsInFuture() {
+            // arrange
+            LocalDate futureDate = LocalDate.now().plusDays(1);
+
+            // act & assert
+            assertThatThrownBy(() -> new BirthDate(futureDate))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("과거 날짜여야 합니다.");
+        }
+    }
+
+    @DisplayName("날짜를 문자열로 변환할 때, ")
+    @Nested
+    class Conversion {
+
+        @DisplayName("yyyyMMdd 형식의 문자열을 반환한다.")
+        @Test
+        void toDateString_returnsFormattedString() {
+            // arrange
+            BirthDate birthDate = new BirthDate(LocalDate.of(1988, 12, 5));
+
+            // act
+            String result = birthDate.toDateString();
+
+            // assert
+            assertThat(result).isEqualTo("19881205");
+        }
+    }
+}

From c8625fe788485be5359c34f57cfd5f536e0725e0 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 19:43:21 +0900
Subject: [PATCH 07/29] =?UTF-8?q?feat:=20=EB=A1=9C=EA=B7=B8=EC=9D=B8Id=20?=
 =?UTF-8?q?=EC=83=9D=EC=84=B1=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/com/loopers/domain/LoginId.java | 30 ++++++++++++-
 .../java/com/loopers/domain/LoginIdTest.java  | 42 +++++++++++++++++++
 2 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/LoginIdTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
index d959fead..d932cdfc 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
@@ -1,7 +1,35 @@
 package com.loopers.domain;
 
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import java.util.regex.Pattern;
+
 public class LoginId {
-    public LoginId(String testuser123) {
+    private static final int MIN_LENGTH = 4;
+    private static final int MAX_LENGTH = 12;
+
+    private static final Pattern ALPHANUMERIC_PATTERN = Pattern.compile("^[a-zA-Z0-9]*$");
+
+    private final String value;
+
+    public LoginId(String value) {
+        validate(value);
+        this.value = value;
+    }
+
+    private void validate(String value) {
+        if (value == null || value.isBlank()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "로그인 ID는 비어있을 수 없습니다.");
+        }
+        if (value.length() < MIN_LENGTH || value.length() > MAX_LENGTH) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "로그인 ID는 4자에서 12자 사이여야 합니다.");
+        }
+        if (!ALPHANUMERIC_PATTERN.matcher(value).matches()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "로그인 ID는 영문과 숫자만 허용됩니다.");
+        }
+    }
 
+    public String getValue() {
+        return value;
     }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/LoginIdTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/LoginIdTest.java
new file mode 100644
index 00000000..36e3c898
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/LoginIdTest.java
@@ -0,0 +1,42 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import com.loopers.support.error.CoreException;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
+
+class LoginIdTest {
+
+    @DisplayName("로그인 ID 객체를 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("4~12자의 영문/숫자가 주어지면, 정상적으로 생성된다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"user123", "loop", "loopers2026"})
+        void createLoginId_whenValidValue(String validValue) {
+            LoginId loginId = new LoginId(validValue);
+            assertThat(loginId.getValue()).isEqualTo(validValue);
+        }
+
+        @DisplayName("4자 미만이거나 12자를 초과하면 예외가 발생한다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"abc", "longloginid123"})
+        void createLoginId_whenLengthIsInvalid(String invalidLengthValue) {
+            assertThatThrownBy(() -> new LoginId(invalidLengthValue))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("영문/숫자가 아닌 문자가 포함되면 예외가 발생한다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"user!", "로그인id", "user 12"})
+        void createLoginId_whenContainsInvalidChars(String invalidCharValue) {
+            assertThatThrownBy(() -> new LoginId(invalidCharValue))
+                    .isInstanceOf(CoreException.class);
+        }
+    }
+}

From 57e6adab4a2b56d4c43e7894c2d1108fe17a067c Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 19:48:50 +0900
Subject: [PATCH 08/29] =?UTF-8?q?feat:=20=EC=9D=B4=EB=A6=84=20=EB=A7=88?=
 =?UTF-8?q?=EC=8A=A4=ED=82=B9=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/com/loopers/domain/Name.java    |  5 ++++
 .../java/com/loopers/domain/NameTest.java     | 24 +++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
index 69ba5bb2..69afba89 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
@@ -21,4 +21,9 @@ private void validate(String name) {
             throw new CoreException(ErrorType.BAD_REQUEST, "유효하지 않은 이름 길이입니다.");
         }
     }
+
+    public String getMaskedName() {
+        if (name == null || name.isEmpty()) return name;
+        return name.substring(0, name.length() - 1) + "*";
+    }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java
index 4fb93454..eeb4796e 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/NameTest.java
@@ -8,6 +8,7 @@
 import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.CsvSource;
 import org.junit.jupiter.params.provider.ValueSource;
 
 class NameTest {
@@ -59,4 +60,27 @@ void createName_whenNameIsTooLong() {
             assertThatThrownBy(() -> new Name(longName))
                     .isInstanceOf(CoreException.class);}
     }
+
+    @DisplayName("이름을 마스킹할 때, ")
+    @Nested
+    class Masking {
+
+        @DisplayName("이름의 마지막 글자가 '*'로 치환된다.")
+        @ParameterizedTest
+        @CsvSource({
+                "홍길, 홍*",
+                "홍길동, 홍길*",
+                "가나다라마, 가나다라*"
+        })
+        void getMaskedName_shouldMaskLastCharacter(String original, String expected) {
+            // arrange
+            Name name = new Name(original);
+
+            // act
+            String maskedName = name.getMaskedName();
+
+            // assert
+            assertThat(maskedName).isEqualTo(expected);
+        }
+    }
 }

From 0243f121c3f08d618972576ff86a621610b48ddc Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 19:53:47 +0900
Subject: [PATCH 09/29] =?UTF-8?q?feat:=20=EC=9D=B4=EB=A9=94=EC=9D=BC=20?=
 =?UTF-8?q?=EC=83=9D=EC=84=B1=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../main/java/com/loopers/domain/Email.java   |  4 +-
 .../java/com/loopers/domain/EmailTest.java    | 66 +++++++++++++++++++
 2 files changed, 67 insertions(+), 3 deletions(-)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/EmailTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Email.java b/apps/commerce-api/src/main/java/com/loopers/domain/Email.java
index 71ea1a7a..767b156b 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Email.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Email.java
@@ -11,9 +11,7 @@
 @Getter
 @EqualsAndHashCode
 public class Email {
-    private static final Pattern EMAIL_PATTERN = Pattern.compile(
-            "^[A-Za-z0-9+_.-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$"
-    );
+    private static final Pattern EMAIL_PATTERN = Pattern.compile("^[A-Za-z0-9+_.-]+@([A-Za-z0-9-]+\\.)+[A-Za-z]{2,}$");
 
     private String mail;
 
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/EmailTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/EmailTest.java
new file mode 100644
index 00000000..245c1f36
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/EmailTest.java
@@ -0,0 +1,66 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import com.loopers.support.error.CoreException;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
+
+class EmailTest {
+
+    @DisplayName("이메일 객체를 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("올바른 이메일 형식이 주어지면, 정상적으로 생성된다.")
+        @ParameterizedTest
+        @ValueSource(strings = {
+                "test@example.com",
+                "user.name+tag@domain.co.kr",
+                "12345@loopers.io",
+                "email@sub.domain.com"
+        })
+        void createEmail_whenValidFormat(String validEmail) {
+            // act
+            Email email = new Email(validEmail);
+
+            // assert
+            assertThat(email.getMail()).isEqualTo(validEmail);
+        }
+
+        @DisplayName("이메일이 null이거나 비어있으면 예외가 발생한다.")
+        @ParameterizedTest
+        @ValueSource(strings = {"", " ", "   "})
+        void createEmail_whenNullOrBlank(String blankEmail) {
+            // null 케이스 별도 테스트
+            assertThatThrownBy(() -> new Email(null))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("이메일은 비어있을 수 없습니다.");
+
+            // 공백 케이스
+            assertThatThrownBy(() -> new Email(blankEmail))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("이메일은 비어있을 수 없습니다.");
+        }
+
+        @DisplayName("형식이 올바르지 않으면 예외가 발생한다.")
+        @ParameterizedTest
+        @ValueSource(strings = {
+                "plainaddress",      // @ 없음
+                "#@%^%#$@#$@#.com",  // 특수문자 남발
+                "@domain.com",       // 로컬 파트 없음
+                "Joe Smith <email@domain.com>", // 이름 포함
+                "email.domain.com",  // @ 없음
+                "email@domain@domain.com", // @ 중복
+                "email@domain..com"  // 도메인 마침표 중복
+        })
+        void createEmail_whenInvalidFormat(String invalidEmail) {
+            assertThatThrownBy(() -> new Email(invalidEmail))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("이메일 형식이 올바르지 않습니다.");
+        }
+    }
+}

From 2398e8175e2079b85c8ad8cc3c1980cb768dae1b Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 21:42:08 +0900
Subject: [PATCH 10/29] =?UTF-8?q?feat:=20=ED=8C=A8=EC=8A=A4=EC=9B=8C?=
 =?UTF-8?q?=EB=93=9C=20=EC=83=9D=EC=84=B1=20=EB=B0=8F=20=EC=83=9D=EC=9D=BC?=
 =?UTF-8?q?=20=EA=B2=80=EC=A6=9D=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/com/loopers/domain/BirthDate.java    |  5 +-
 .../java/com/loopers/domain/Password.java     | 36 +++++++++--
 .../java/com/loopers/domain/PasswordTest.java | 61 +++++++++++++++++++
 .../com/loopers/domain/UserModelTest.java     |  2 +-
 4 files changed, 96 insertions(+), 8 deletions(-)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/PasswordTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
index 6f88bc17..3fc0ad51 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
@@ -4,7 +4,9 @@
 import com.loopers.support.error.ErrorType;
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
+import lombok.EqualsAndHashCode;
 
+@EqualsAndHashCode
 public class BirthDate {
 
     private static final DateTimeFormatter DATE_STRING_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
@@ -26,7 +28,8 @@ private void validate(LocalDate birthDate) {
     }
 
     public String toDateString() {
-        return birthDate.format(DATE_STRING_FORMATTER);    }
+        return birthDate.format(DATE_STRING_FORMATTER);
+    }
 
     public LocalDate getDate() {
         return birthDate;
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
index 7a23c236..f65af367 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
@@ -2,19 +2,43 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import java.util.regex.Pattern;
+import lombok.EqualsAndHashCode;
 
+@EqualsAndHashCode
 public class Password {
-    private final String password;
+    // 특수문자 범위를 ~!@#$%^&*()_+=- 로 확장했습니다.
+    private static final Pattern PASSWORD_PATTERN =
+            Pattern.compile("^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[~!@#$%^&*()_+=-])[A-Za-z\\d~!@#$%^&*()_+=-]{8,16}$");
 
-    public Password(String password) {
-        this.password = password;
+    private final String value;
+
+    public Password(String value) {
+        validate(value);
+        this.value = value;
+    }
+
+    private void validate(String value) {
+        if (value == null || !PASSWORD_PATTERN.matcher(value).matches()) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "비밀번호는 8~16자의 영문 대소문자, 숫자, 특수문자 조합이어야 합니다.");
+        }
     }
 
     public void validateNotContainBirthday(BirthDate birthDate) {
-        String targetDate = birthDate.toDateString();
+        String birthDateString = birthDate.toDateString();
 
-        if (this.password.contains(targetDate)) {
-            throw new CoreException(ErrorType.BAD_REQUEST,"생년월일은 비밀번호 내에 포함될 수 없습니다");
+        if (this.value.contains(birthDateString)) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "생년월일은 비밀번호 내에 포함될 수 없습니다.");
         }
     }
+
+    public void validateNotSameAs(Password other) {
+        if (this.equals(other)) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "현재 사용 중인 비밀번호는 사용할 수 없습니다.");
+        }
+    }
+
+    public String getValue() {
+        return value;
+    }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/PasswordTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/PasswordTest.java
new file mode 100644
index 00000000..50d2220e
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/PasswordTest.java
@@ -0,0 +1,61 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+import com.loopers.support.error.CoreException;
+import java.time.LocalDate;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+
+class PasswordTest {
+
+    @DisplayName("비밀번호 객체를 생성할 때, ")
+    @Nested
+    class Create {
+
+        @DisplayName("8~16자의 영문 대소문자, 숫자, 특수문자가 모두 포함되면 정상 생성된다.")
+        @Test
+        void createPassword_whenValidFormat() {
+            // 대문자(V), 소문자(alid), 숫자(123), 특수문자(!@#) 모두 포함
+            assertDoesNotThrow(() -> new Password("Valid123!@#"));
+        }
+
+        @DisplayName("규칙에 어긋나는 형식이면 예외가 발생한다.")
+        @Test
+        void createPassword_whenInvalidFormat() {
+            assertThatThrownBy(() -> new Password("invalid"))
+                    .isInstanceOf(CoreException.class);
+        }
+    }
+
+    @DisplayName("비밀번호 비즈니스 규칙을 검증할 때, ")
+    @Nested
+    class Validation {
+
+        @DisplayName("비밀번호에 생년월일(yyyyMMdd)이 포함되어 있으면 예외가 발생한다.")
+        @Test
+        void validateNotContainBirthday_fail() {
+            // arrange: 정규식을 통과하기 위해 대문자 'P' 추가
+            Password password = new Password("Pw19900115!");
+            BirthDate birthDate = new BirthDate(LocalDate.of(1990, 1, 15));
+
+            // act & assert
+            assertThatThrownBy(() -> password.validateNotContainBirthday(birthDate))
+                    .isInstanceOf(CoreException.class);
+        }
+
+        @DisplayName("수정하려는 비밀번호가 기존 비밀번호와 동일하면 예외가 발생한다.")
+        @Test
+        void validateNotSameAs_fail() {
+            // arrange
+            Password currentPassword = new Password("Current123!");
+            Password newPassword = new Password("Current123!");
+
+            // act & assert
+            assertThatThrownBy(() -> newPassword.validateNotSameAs(currentPassword))
+                    .isInstanceOf(CoreException.class);
+        }
+    }
+}
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
index eaf9ea6f..fb0f36b4 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
@@ -88,7 +88,7 @@ void createUserModel_whenEmailIsNull() {
         void createUserModel_whenPasswordContainsBirthDate() {
             // arrange
             BirthDate birthDate = new BirthDate(LocalDate.of(1990, 1, 15));
-            Password passwordWithBirthDate = new Password("pw19900115!");
+            Password passwordWithBirthDate = new Password("Pw19900115!");
 
             // expect
             assertThatThrownBy(() -> new UserModel(validLoginId, passwordWithBirthDate, validName, birthDate, validEmail))

From c130402d46334d61c9c5459973df13a55d2266e5 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 22:40:27 +0900
Subject: [PATCH 11/29] =?UTF-8?q?feat:=20=ED=9A=8C=EC=9B=90=EA=B0=80?=
 =?UTF-8?q?=EC=9E=85=20=EA=B8=B0=EB=8A=A5=20=EA=B5=AC=ED=98=84=20=EB=B0=8F?=
 =?UTF-8?q?=20=ED=86=B5=ED=95=A9=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20=EC=9E=91?=
 =?UTF-8?q?=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/com/loopers/domain/BirthDate.java    |  6 +-
 .../main/java/com/loopers/domain/LoginId.java |  8 ++-
 .../main/java/com/loopers/domain/Name.java    |  8 ++-
 .../java/com/loopers/domain/Password.java     |  6 +-
 .../java/com/loopers/domain/UserModel.java    | 15 ++--
 .../com/loopers/domain/UserRepository.java    |  9 +++
 .../java/com/loopers/domain/UserService.java  | 25 +++++++
 .../infrastructure/UserJpaRepository.java     | 10 +++
 .../infrastructure/UserRepositoryImpl.java    | 24 +++++++
 .../domain/UserServiceIntegrationTest.java    | 68 +++++++++++++++++++
 10 files changed, 167 insertions(+), 12 deletions(-)
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/UserRepository.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/infrastructure/UserJpaRepository.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/infrastructure/UserRepositoryImpl.java
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
index 3fc0ad51..8dcb741c 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/BirthDate.java
@@ -2,16 +2,20 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embeddable;
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
 import lombok.EqualsAndHashCode;
 
+@Embeddable
 @EqualsAndHashCode
 public class BirthDate {
 
     private static final DateTimeFormatter DATE_STRING_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
 
-    private final LocalDate birthDate;
+    private LocalDate birthDate;
+
+    protected BirthDate() {}
 
     public BirthDate(LocalDate birthDate) {
         validate(birthDate);
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
index d932cdfc..98e718ed 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/LoginId.java
@@ -2,15 +2,21 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embeddable;
 import java.util.regex.Pattern;
+import lombok.EqualsAndHashCode;
 
+@Embeddable
+@EqualsAndHashCode
 public class LoginId {
     private static final int MIN_LENGTH = 4;
     private static final int MAX_LENGTH = 12;
 
     private static final Pattern ALPHANUMERIC_PATTERN = Pattern.compile("^[a-zA-Z0-9]*$");
 
-    private final String value;
+    private String value;
+
+    protected LoginId() {}
 
     public LoginId(String value) {
         validate(value);
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
index 69afba89..e7495e8c 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Name.java
@@ -2,11 +2,17 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embeddable;
+import lombok.EqualsAndHashCode;
 
+@Embeddable
+@EqualsAndHashCode
 public class Name {
     private final static int MIN_LENGTH = 2;
     private final static int MAX_LENGTH = 10;
-    private final String name;
+    private String name;
+
+    protected Name() {}
 
     public Name(String name) {
         validate(name);
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
index f65af367..25143cf1 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
@@ -2,16 +2,20 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.persistence.Embeddable;
 import java.util.regex.Pattern;
 import lombok.EqualsAndHashCode;
 
+@Embeddable
 @EqualsAndHashCode
 public class Password {
     // 특수문자 범위를 ~!@#$%^&*()_+=- 로 확장했습니다.
     private static final Pattern PASSWORD_PATTERN =
             Pattern.compile("^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[~!@#$%^&*()_+=-])[A-Za-z\\d~!@#$%^&*()_+=-]{8,16}$");
 
-    private final String value;
+    private String value;
+
+    protected Password() {}
 
     public Password(String value) {
         validate(value);
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
index a4e79160..679704fd 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
@@ -2,11 +2,10 @@
 
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
+import jakarta.persistence.AttributeOverride;
+import jakarta.persistence.Column;
 import jakarta.persistence.Embedded;
 import jakarta.persistence.Entity;
-import jakarta.persistence.GeneratedValue;
-import jakarta.persistence.GenerationType;
-import jakarta.persistence.Id;
 import jakarta.persistence.Table;
 import lombok.AccessLevel;
 import lombok.AllArgsConstructor;
@@ -17,26 +16,26 @@
 @Entity
 @Table(name = "users")
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
-@AllArgsConstructor
 public class UserModel extends BaseEntity {
 
-    @Id
-    @GeneratedValue(strategy = GenerationType.IDENTITY)
-    private Long id;
-
     @Embedded
+    @AttributeOverride(name = "value", column = @Column(name = "login_id"))
     private LoginId loginId;
 
     @Embedded
+    @AttributeOverride(name = "value", column = @Column(name = "password"))
     private Password password;
 
     @Embedded
+    @AttributeOverride(name = "name", column = @Column(name = "name"))
     private Name name;
 
     @Embedded
+    @AttributeOverride(name = "birthDate", column = @Column(name = "birth_date"))
     private BirthDate birthDate;
 
     @Embedded
+    @AttributeOverride(name = "mail", column = @Column(name = "email"))
     private Email email;
 
     public UserModel(LoginId loginId, Password password, Name name, BirthDate birthDate, Email email) {
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserRepository.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserRepository.java
new file mode 100644
index 00000000..64706be3
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserRepository.java
@@ -0,0 +1,9 @@
+package com.loopers.domain;
+
+import java.util.Optional;
+
+public interface UserRepository {
+    UserModel save(UserModel userModel);
+
+    Optional<UserModel> find(LoginId loginId);
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
new file mode 100644
index 00000000..6820cd89
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
@@ -0,0 +1,25 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class UserService {
+    private final UserRepository userRepository;
+
+    @Transactional
+    public UserModel signup(LoginId loginId, Password password, Name name, BirthDate birthDate, Email email) {
+
+        if(userRepository.find(loginId).isPresent()) {
+            throw new CoreException(ErrorType.BAD_REQUEST,"이미 존재하는 아이디입니다.");
+        }
+
+        UserModel userModel = new UserModel(loginId,password,name,birthDate,email);
+
+        return userRepository.save(userModel);
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserJpaRepository.java b/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserJpaRepository.java
new file mode 100644
index 00000000..adf3d6a3
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserJpaRepository.java
@@ -0,0 +1,10 @@
+package com.loopers.infrastructure;
+
+import com.loopers.domain.LoginId;
+import com.loopers.domain.UserModel;
+import java.util.Optional;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface UserJpaRepository extends JpaRepository<UserModel,Long> {
+    Optional<UserModel> findByLoginId(LoginId loginId);
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserRepositoryImpl.java b/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserRepositoryImpl.java
new file mode 100644
index 00000000..afecf020
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/infrastructure/UserRepositoryImpl.java
@@ -0,0 +1,24 @@
+package com.loopers.infrastructure;
+
+import com.loopers.domain.LoginId;
+import com.loopers.domain.UserModel;
+import com.loopers.domain.UserRepository;
+import java.util.Optional;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+@RequiredArgsConstructor
+@Component
+public class UserRepositoryImpl implements UserRepository {
+    private final UserJpaRepository userJpaRepository;
+
+    @Override
+    public UserModel save(UserModel userModel) {
+        return userJpaRepository.save(userModel);
+    }
+
+    @Override
+    public Optional<UserModel> find(LoginId loginId) {
+        return userJpaRepository.findByLoginId(loginId);
+    }
+}
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
new file mode 100644
index 00000000..8951953b
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
@@ -0,0 +1,68 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertAll;
+
+import com.loopers.infrastructure.UserJpaRepository;
+import com.loopers.utils.DatabaseCleanUp;
+import java.time.LocalDate;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+public class UserServiceIntegrationTest {
+    @Autowired
+    private UserService userService;
+
+    @Autowired
+    private UserJpaRepository userJpaRepository;
+
+    @Autowired
+    private DatabaseCleanUp databaseCleanUp;
+
+    private LoginId validLoginId;
+    private Password validPassword;
+    private Name validName;
+    private BirthDate validBirthDate;
+    private Email validEmail;
+
+    @BeforeEach
+    void setUp() {
+        validLoginId = new LoginId("testuser123");
+        validPassword = new Password("Test1234!@#");
+        validName = new Name("홍길동");
+        validBirthDate = new BirthDate(LocalDate.of(1990, 1, 15));
+        validEmail = new Email("test@example.com");
+    }
+
+    @AfterEach
+    void tearDown() {
+        databaseCleanUp.truncateAllTables();
+    }
+
+    @DisplayName("유저가 회원가입할 때")
+    @Nested
+    class SingUp{
+            @DisplayName("로그인 ID, 비밀번호, 이름, 생년월일, 이메일을 주면, 회원가입을 한다.")
+            @Test
+            void signup_whenAllInfoProvided() {
+                // act
+                UserModel result = userService.signup(validLoginId,validPassword,validName,validBirthDate,validEmail);
+
+                // assert
+                assertAll(
+                        () -> assertThat(result).isNotNull(),
+                        () -> assertThat(result.getLoginId()).isEqualTo(validLoginId),
+                        () -> assertThat(result.getPassword()).isEqualTo(validPassword),
+                        () -> assertThat(result.getName()).isEqualTo(validName),
+                        () -> assertThat(result.getBirthDate()).isEqualTo(validBirthDate),
+                        () -> assertThat(result.getEmail()).isEqualTo(validEmail)
+                );
+            }
+    }
+}

From 47c6353f7303e665c246a2e45219239cda6264ed Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 23:09:47 +0900
Subject: [PATCH 12/29] =?UTF-8?q?feat:=20=ED=9A=8C=EC=9B=90=EA=B0=80?=
 =?UTF-8?q?=EC=9E=85=20API=20=EA=B5=AC=ED=98=84=20=EB=B0=8F=20E2E=20?=
 =?UTF-8?q?=ED=85=8C=EC=8A=A4=ED=8A=B8=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../interfaces/api/ApiControllerAdvice.java   |   9 +
 .../interfaces/api/user/UserV1ApiSpec.java    |  19 +
 .../interfaces/api/user/UserV1Controller.java |  40 +++
 .../interfaces/api/user/UserV1Dto.java        |  55 +++
 .../interfaces/api/UserV1ApiE2ETest.java      | 340 ++++++++++++++++++
 http/commerce-api/user-v1.http                | 131 +++++++
 6 files changed, 594 insertions(+)
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
 create mode 100644 http/commerce-api/user-v1.http

diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/ApiControllerAdvice.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/ApiControllerAdvice.java
index 20b2809c..2ec0dbbd 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/ApiControllerAdvice.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/ApiControllerAdvice.java
@@ -8,6 +8,8 @@
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.ResponseEntity;
 import org.springframework.http.converter.HttpMessageNotReadableException;
+import org.springframework.validation.FieldError;
+import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.MissingServletRequestParameterException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
@@ -46,6 +48,13 @@ public ResponseEntity<ApiResponse<?>> handleBadRequest(MissingServletRequestPara
         return failureResponse(ErrorType.BAD_REQUEST, message);
     }
 
+    @ExceptionHandler
+    public ResponseEntity<ApiResponse<?>> handleBadRequest(MethodArgumentNotValidException e) {
+        FieldError fieldError = e.getBindingResult().getFieldError();
+        String message = fieldError != null ? fieldError.getDefaultMessage() : "잘못된 요청입니다.";
+        return failureResponse(ErrorType.BAD_REQUEST, message);
+    }
+
     @ExceptionHandler
     public ResponseEntity<ApiResponse<?>> handleBadRequest(HttpMessageNotReadableException e) {
         String errorMessage;
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
new file mode 100644
index 00000000..cbf0dd88
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
@@ -0,0 +1,19 @@
+package com.loopers.interfaces.api.user;
+
+import com.loopers.interfaces.api.ApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.parameters.RequestBody;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = "User V1 API", description = "사용자 API 입니다.")
+public interface UserV1ApiSpec {
+
+    @Operation(
+        summary = "회원가입",
+        description = "새로운 사용자를 등록합니다."
+    )
+    ApiResponse<UserV1Dto.SignupResponse> signup(
+        @RequestBody(description = "회원가입 요청 정보")
+        UserV1Dto.SignupRequest request
+    );
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
new file mode 100644
index 00000000..8e7df7fc
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
@@ -0,0 +1,40 @@
+package com.loopers.interfaces.api.user;
+
+import com.loopers.domain.*;
+import com.loopers.interfaces.api.ApiResponse;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/api/v1/users")
+public class UserV1Controller implements UserV1ApiSpec {
+
+    private static final DateTimeFormatter BIRTH_DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
+
+    private final UserService userService;
+
+    @PostMapping("/signup")
+    @Override
+    public ApiResponse<UserV1Dto.SignupResponse> signup(
+        @Valid @RequestBody UserV1Dto.SignupRequest request
+    ) {
+        LoginId loginId = new LoginId(request.loginId());
+        Password password = new Password(request.password());
+        Name name = new Name(request.name());
+        BirthDate birthDate = new BirthDate(LocalDate.parse(request.birthDate(), BIRTH_DATE_FORMATTER));
+        Email email = new Email(request.email());
+
+        UserModel userModel = userService.signup(loginId, password, name, birthDate, email);
+        UserV1Dto.SignupResponse response = UserV1Dto.SignupResponse.from(userModel);
+
+        return ApiResponse.success(response);
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
new file mode 100644
index 00000000..487a6a42
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
@@ -0,0 +1,55 @@
+package com.loopers.interfaces.api.user;
+
+import com.loopers.domain.UserModel;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+import jakarta.validation.constraints.Size;
+
+public class UserV1Dto {
+
+    public record SignupRequest(
+        @NotBlank(message = "로그인 ID는 필수 입력값입니다.")
+        @Size(min = 4, max = 12, message = "로그인 ID는 4자에서 12자 사이여야 합니다.")
+        @Pattern(regexp = "^[a-zA-Z0-9]*$", message = "로그인 ID는 영문과 숫자만 허용됩니다.")
+        String loginId,
+
+        @NotBlank(message = "비밀번호는 필수 입력값입니다.")
+        @Pattern(
+            regexp = "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[~!@#$%^&*()_+=-])[A-Za-z\\d~!@#$%^&*()_+=-]{8,16}$",
+            message = "비밀번호는 8~16자의 영문 대소문자, 숫자, 특수문자 조합이어야 합니다."
+        )
+        String password,
+
+        @NotBlank(message = "이름은 필수 입력값입니다.")
+        @Size(min = 2, max = 10, message = "이름은 2자에서 10자 사이여야 합니다.")
+        String name,
+
+        @NotBlank(message = "생년월일은 필수 입력값입니다.")
+        @Pattern(regexp = "^\\d{8}$", message = "생년월일은 yyyyMMdd 형식이어야 합니다.")
+        String birthDate,
+
+        @NotBlank(message = "이메일은 필수 입력값입니다.")
+        @Email(message = "이메일 형식이 올바르지 않습니다.")
+        String email
+    ) {
+    }
+
+    public record SignupResponse(
+        Long id,
+        String loginId,
+        String name,
+        String birthDate,
+        String email
+    ) {
+        public static SignupResponse from(UserModel model) {
+            return new SignupResponse(
+                model.getId(),
+                model.getLoginId().getValue(),
+                model.getName().getMaskedName(),
+                model.getBirthDate().toDateString(),
+                model.getEmail().getMail()
+            );
+        }
+    }
+}
diff --git a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
new file mode 100644
index 00000000..dad89be6
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
@@ -0,0 +1,340 @@
+package com.loopers.interfaces.api;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertAll;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.loopers.infrastructure.UserJpaRepository;
+import com.loopers.interfaces.api.user.UserV1Dto;
+import com.loopers.utils.DatabaseCleanUp;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.test.web.client.TestRestTemplate;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.http.HttpEntity;
+import org.springframework.http.HttpMethod;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+class UserV1ApiE2ETest {
+
+    private static final String ENDPOINT_SIGNUP = "/api/v1/users/signup";
+
+    private final TestRestTemplate testRestTemplate;
+    private final UserJpaRepository userJpaRepository;
+    private final DatabaseCleanUp databaseCleanUp;
+
+    @Autowired
+    public UserV1ApiE2ETest(
+        TestRestTemplate testRestTemplate,
+        UserJpaRepository userJpaRepository,
+        DatabaseCleanUp databaseCleanUp
+    ) {
+        this.testRestTemplate = testRestTemplate;
+        this.userJpaRepository = userJpaRepository;
+        this.databaseCleanUp = databaseCleanUp;
+    }
+
+    @AfterEach
+    void tearDown() {
+        databaseCleanUp.truncateAllTables();
+    }
+
+    @DisplayName("POST /api/v1/users/signup")
+    @Nested
+    class Signup {
+
+        @DisplayName("유효한 회원가입 정보를 주면, 회원가입에 성공하고 사용자 정보를 반환한다.")
+        @Test
+        void returnsUserInfo_whenValidSignupRequestIsProvided() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is2xxSuccessful()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK),
+                () -> assertThat(response.getBody().data().loginId()).isEqualTo("testuser1"),
+                () -> assertThat(response.getBody().data().name()).isEqualTo("홍길*"),
+                () -> assertThat(response.getBody().data().birthDate()).isEqualTo("19900101"),
+                () -> assertThat(response.getBody().data().email()).isEqualTo("test@example.com"),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(1)
+            );
+        }
+
+        @DisplayName("로그인 ID가 4자 미만이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenLoginIdIsTooShort() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "abc",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("로그인 ID가 12자 초과이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenLoginIdIsTooLong() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser12345",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("로그인 ID에 특수문자가 포함되면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenLoginIdContainsSpecialCharacters() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "test@user",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("비밀번호가 8자 미만이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenPasswordIsTooShort() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test12!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("비밀번호가 16자 초과이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenPasswordIsTooLong() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234567890123!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("비밀번호에 생년월일이 포함되면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenPasswordContainsBirthDate() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test19900101!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("이메일 형식이 올바르지 않으면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenEmailFormatIsInvalid() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "invalid-email"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("이미 존재하는 로그인 ID로 회원가입하면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenLoginIdAlreadyExists() {
+            // arrange
+            UserV1Dto.SignupRequest firstRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test1@example.com"
+            );
+            UserV1Dto.SignupRequest secondRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test5678!",
+                "김철수",
+                "19950505",
+                "test2@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(firstRequest), responseType);
+
+            // act
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(secondRequest), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(1)
+            );
+        }
+
+        @DisplayName("이름이 2자 미만이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenNameIsTooShort() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+
+        @DisplayName("이름이 10자 초과이면, 400 BAD_REQUEST 응답을 받는다.")
+        @Test
+        void throwsBadRequest_whenNameIsTooLong() {
+            // arrange
+            UserV1Dto.SignupRequest request = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동김철수박영희최강",
+                "19900101",
+                "test@example.com"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(request), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST),
+                () -> assertThat(userJpaRepository.count()).isEqualTo(0)
+            );
+        }
+    }
+}
diff --git a/http/commerce-api/user-v1.http b/http/commerce-api/user-v1.http
new file mode 100644
index 00000000..58ee4cb9
--- /dev/null
+++ b/http/commerce-api/user-v1.http
@@ -0,0 +1,131 @@
+### 회원가입 - 성공 케이스
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test1234!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 로그인 ID 4자 미만 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "abc",
+  "password": "Test1234!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 로그인 ID 12자 초과 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser12345",
+  "password": "Test1234!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 로그인 ID 특수문자 포함 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "test@user",
+  "password": "Test1234!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 비밀번호 8자 미만 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test12!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 비밀번호 16자 초과 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test1234567890123!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 비밀번호에 생년월일 포함 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test19900101!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 이메일 형식 오류 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test1234!",
+  "name": "홍길동",
+  "birthDate": "19900101",
+  "email": "invalid-email"
+}
+
+### 회원가입 - 이름 2자 미만 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test1234!",
+  "name": "홍",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 이름 10자 초과 (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test1234!",
+  "name": "홍길동김철수박영희최강",
+  "birthDate": "19900101",
+  "email": "test@example.com"
+}
+
+### 회원가입 - 중복 로그인 ID (실패)
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "testuser1",
+  "password": "Test5678!",
+  "name": "김철수",
+  "birthDate": "19950505",
+  "email": "test2@example.com"
+}

From 8620b0d0d0aeff65cb912e8a2e4d88a3d1b661d0 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Thu, 5 Feb 2026 23:23:16 +0900
Subject: [PATCH 13/29] =?UTF-8?q?docs:=20=EA=B8=B0=EB=8A=A5=20=EC=9A=94?=
 =?UTF-8?q?=EA=B5=AC=20=EC=82=AC=ED=95=AD=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ToDoList.md | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/ToDoList.md b/ToDoList.md
index f6a92673..3aa6eddf 100644
--- a/ToDoList.md
+++ b/ToDoList.md
@@ -1,7 +1,9 @@
 # 기능 요구 사항
 
 
-### 1. 회원가입
+## 1. 회원가입
+
+### 요구사항
 - **필요 정보 : { 로그인 ID, 비밀번호, 이름, 생년월일, 이메일 }**
 - 이미 가입된 로그인 ID 로는 가입이 불가능함
 - 각 정보는 포맷에 맞는 검증 필요 (이름, 이메일, 생년월일)
@@ -15,7 +17,9 @@
 > * X-Loopers-LoginPw : 비밀번호
 
 
-### 2. 내 정보 조회
+---
+
+## 2. 내 정보 조회
 - **반환 정보 : { 로그인 ID, 이름, 생년월일, 이메일 }**
 - 로그인 ID 는 영문과 숫자만 허용
 - 이름은 마지막 글자를 마스킹해 반환
@@ -23,10 +27,16 @@
 > 마스킹 문자는 `*` 로 통일
 >
 
-### 3. 비밀번호 수정
+---
+
+## 3. 비밀번호 수정
 - **필요 정보 : { 기존 비밀번호, 새 비밀번호 }**
 - 비밀 번호 RULE 을 따르되, 현재 비밀번호는 사용할 수 없습니다.
 
 > **비밀번호 RULE**
 > * 영문 대/소문자, 숫자, 특수문자 사용 가능
 > * 생년월일 사용 불가
+
+
+---
+

From 7472c4cd2e38568b1220aba2fd7e0feef860c9a7 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:26 +0900
Subject: [PATCH 14/29] =?UTF-8?q?feat:=20=EC=82=AC=EC=9A=A9=EC=9E=90=20?=
 =?UTF-8?q?=EC=9D=B8=EC=A6=9D=20=EC=84=9C=EB=B9=84=EC=8A=A4=20=EA=B5=AC?=
 =?UTF-8?q?=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../loopers/domain/AuthenticationService.java | 27 +++++++++++++++++++
 .../com/loopers/support/error/ErrorType.java  |  1 +
 2 files changed, 28 insertions(+)
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java b/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java
new file mode 100644
index 00000000..97734843
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java
@@ -0,0 +1,27 @@
+package com.loopers.domain;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+@Service
+@RequiredArgsConstructor
+public class AuthenticationService {
+
+    private final UserRepository userRepository;
+
+    public UserModel authenticate(String loginIdValue, String rawPassword) {
+        LoginId loginId = new LoginId(loginIdValue);
+        Password password = new Password(rawPassword);
+
+        UserModel user = userRepository.find(loginId)
+            .orElseThrow(() -> new CoreException(ErrorType.UNAUTHORIZED, "로그인 ID 또는 비밀번호가 일치하지 않습니다."));
+
+        if (!user.getPassword().equals(password)) {
+            throw new CoreException(ErrorType.UNAUTHORIZED, "로그인 ID 또는 비밀번호가 일치하지 않습니다.");
+        }
+
+        return user;
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/support/error/ErrorType.java b/apps/commerce-api/src/main/java/com/loopers/support/error/ErrorType.java
index 5d142efb..8d493491 100644
--- a/apps/commerce-api/src/main/java/com/loopers/support/error/ErrorType.java
+++ b/apps/commerce-api/src/main/java/com/loopers/support/error/ErrorType.java
@@ -10,6 +10,7 @@ public enum ErrorType {
     /** 범용 에러 */
     INTERNAL_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, HttpStatus.INTERNAL_SERVER_ERROR.getReasonPhrase(), "일시적인 오류가 발생했습니다."),
     BAD_REQUEST(HttpStatus.BAD_REQUEST, HttpStatus.BAD_REQUEST.getReasonPhrase(), "잘못된 요청입니다."),
+    UNAUTHORIZED(HttpStatus.UNAUTHORIZED, HttpStatus.UNAUTHORIZED.getReasonPhrase(), "인증에 실패했습니다."),
     NOT_FOUND(HttpStatus.NOT_FOUND, HttpStatus.NOT_FOUND.getReasonPhrase(), "존재하지 않는 요청입니다."),
     CONFLICT(HttpStatus.CONFLICT, HttpStatus.CONFLICT.getReasonPhrase(), "이미 존재하는 리소스입니다.");
 

From 249a25f7403c60bf2d7d3529dd69736899dfb1f3 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:32 +0900
Subject: [PATCH 15/29] =?UTF-8?q?feat:=20=EB=82=B4=20=EC=A0=95=EB=B3=B4=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20=EC=84=9C=EB=B9=84=EC=8A=A4=20=EB=A1=9C?=
 =?UTF-8?q?=EC=A7=81=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/com/loopers/domain/UserService.java        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
index 6820cd89..72a0fd2f 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
@@ -22,4 +22,9 @@ public UserModel signup(LoginId loginId, Password password, Name name, BirthDate
 
         return userRepository.save(userModel);
     }
+
+    public UserModel getMyInfo(LoginId loginId) {
+        return userRepository.find(loginId)
+            .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "사용자를 찾을 수 없습니다."));
+    }
 }

From dc35f185e702869e0561757ecbcd0e65ecbced89 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:37 +0900
Subject: [PATCH 16/29] =?UTF-8?q?feat:=20=EB=82=B4=20=EC=A0=95=EB=B3=B4=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20API=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../interfaces/api/user/UserV1ApiSpec.java    | 12 +++++++++++
 .../interfaces/api/user/UserV1Controller.java | 21 +++++++++++++++----
 .../interfaces/api/user/UserV1Dto.java        | 16 ++++++++++++++
 3 files changed, 45 insertions(+), 4 deletions(-)

diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
index cbf0dd88..1be37d4a 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
@@ -2,6 +2,7 @@
 
 import com.loopers.interfaces.api.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.parameters.RequestBody;
 import io.swagger.v3.oas.annotations.tags.Tag;
 
@@ -16,4 +17,15 @@ ApiResponse<UserV1Dto.SignupResponse> signup(
         @RequestBody(description = "회원가입 요청 정보")
         UserV1Dto.SignupRequest request
     );
+
+    @Operation(
+        summary = "내 정보 조회",
+        description = "인증된 사용자의 정보를 조회합니다. 헤더에 X-Loopers-LoginId와 X-Loopers-LoginPw를 포함해야 합니다."
+    )
+    ApiResponse<UserV1Dto.MyInfoResponse> getMyInfo(
+        @Parameter(description = "로그인 ID", required = true)
+        String loginId,
+        @Parameter(description = "비밀번호", required = true)
+        String password
+    );
 }
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
index 8e7df7fc..e97600d9 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
@@ -4,10 +4,7 @@
 import com.loopers.interfaces.api.ApiResponse;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
@@ -18,8 +15,11 @@
 public class UserV1Controller implements UserV1ApiSpec {
 
     private static final DateTimeFormatter BIRTH_DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
+    private static final String HEADER_LOGIN_ID = "X-Loopers-LoginId";
+    private static final String HEADER_LOGIN_PW = "X-Loopers-LoginPw";
 
     private final UserService userService;
+    private final AuthenticationService authenticationService;
 
     @PostMapping("/signup")
     @Override
@@ -37,4 +37,17 @@ public ApiResponse<UserV1Dto.SignupResponse> signup(
 
         return ApiResponse.success(response);
     }
+
+    @GetMapping("/me")
+    @Override
+    public ApiResponse<UserV1Dto.MyInfoResponse> getMyInfo(
+        @RequestHeader(HEADER_LOGIN_ID) String loginId,
+        @RequestHeader(HEADER_LOGIN_PW) String password
+    ) {
+        UserModel authenticatedUser = authenticationService.authenticate(loginId, password);
+        UserModel userInfo = userService.getMyInfo(authenticatedUser.getLoginId());
+        UserV1Dto.MyInfoResponse response = UserV1Dto.MyInfoResponse.from(userInfo);
+
+        return ApiResponse.success(response);
+    }
 }
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
index 487a6a42..29429429 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
@@ -52,4 +52,20 @@ public static SignupResponse from(UserModel model) {
             );
         }
     }
+
+    public record MyInfoResponse(
+        String loginId,
+        String name,
+        String birthDate,
+        String email
+    ) {
+        public static MyInfoResponse from(UserModel model) {
+            return new MyInfoResponse(
+                model.getLoginId().getValue(),
+                model.getName().getMaskedName(),
+                model.getBirthDate().toDateString(),
+                model.getEmail().getMail()
+            );
+        }
+    }
 }

From b00608d493bee9e35457c69a9e0d366215307248 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:40 +0900
Subject: [PATCH 17/29] =?UTF-8?q?feat:=20=EC=9D=B8=EC=A6=9D=20=EC=84=9C?=
 =?UTF-8?q?=EB=B9=84=EC=8A=A4=20=EB=8B=A8=EC=9C=84=20=ED=85=8C=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/AuthenticationServiceTest.java     | 103 ++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java

diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java
new file mode 100644
index 00000000..234ba177
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java
@@ -0,0 +1,103 @@
+package com.loopers.domain;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import java.time.LocalDate;
+import java.util.Optional;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+@DisplayName("AuthenticationService 단위 테스트")
+@ExtendWith(MockitoExtension.class)
+class AuthenticationServiceTest {
+
+    @Mock
+    private UserRepository userRepository;
+
+    @InjectMocks
+    private AuthenticationService authenticationService;
+
+    private UserModel testUser;
+    private String validLoginId;
+    private String validPassword;
+
+    @BeforeEach
+    void setUp() {
+        validLoginId = "testuser123";
+        validPassword = "Test1234!@#";
+
+        testUser = new UserModel(
+            new LoginId(validLoginId),
+            new Password(validPassword),
+            new Name("홍길동"),
+            new BirthDate(LocalDate.of(1990, 1, 15)),
+            new Email("test@example.com")
+        );
+    }
+
+    @DisplayName("authenticate 메서드는")
+    @Nested
+    class Authenticate {
+
+        @Test
+        @DisplayName("올바른 로그인 ID와 비밀번호로 인증하면 사용자 정보를 반환한다")
+        void authenticate_should_return_user_when_credentials_are_correct() {
+            // arrange
+            when(userRepository.find(any(LoginId.class))).thenReturn(Optional.of(testUser));
+
+            // act
+            UserModel result = authenticationService.authenticate(validLoginId, validPassword);
+
+            // assert
+            assertThat(result).isNotNull();
+            assertThat(result.getLoginId().getValue()).isEqualTo(validLoginId);
+        }
+
+        @Test
+        @DisplayName("존재하지 않는 로그인 ID로 인증하면 UNAUTHORIZED 예외를 던진다")
+        void authenticate_should_throw_exception_when_user_not_found() {
+            // arrange
+            when(userRepository.find(any(LoginId.class))).thenReturn(Optional.empty());
+
+            // act & assert
+            assertThatThrownBy(() -> authenticationService.authenticate(validLoginId, validPassword))
+                .isInstanceOf(CoreException.class)
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.UNAUTHORIZED)
+                .hasMessageContaining("로그인 ID 또는 비밀번호가 일치하지 않습니다.");
+        }
+
+        @Test
+        @DisplayName("잘못된 비밀번호로 인증하면 UNAUTHORIZED 예외를 던진다")
+        void authenticate_should_throw_exception_when_password_is_incorrect() {
+            // arrange
+            when(userRepository.find(any(LoginId.class))).thenReturn(Optional.of(testUser));
+            String wrongPassword = "Wrong1234!@#";
+
+            // act & assert
+            assertThatThrownBy(() -> authenticationService.authenticate(validLoginId, wrongPassword))
+                .isInstanceOf(CoreException.class)
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.UNAUTHORIZED)
+                .hasMessageContaining("로그인 ID 또는 비밀번호가 일치하지 않습니다.");
+        }
+
+        @Test
+        @DisplayName("비밀번호가 null이면 BAD_REQUEST 예외를 던진다")
+        void authenticate_should_throw_exception_when_password_is_null() {
+            // act & assert
+            assertThatThrownBy(() -> authenticationService.authenticate(validLoginId, null))
+                .isInstanceOf(CoreException.class)
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.BAD_REQUEST);
+        }
+    }
+}

From 264e51ad79d822d592e82ef8466c926f462db645 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:46 +0900
Subject: [PATCH 18/29] =?UTF-8?q?feat:=20=EB=82=B4=20=EC=A0=95=EB=B3=B4=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20=ED=86=B5=ED=95=A9=20=ED=85=8C=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=20=EB=B0=8F=20E2E=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20?=
 =?UTF-8?q?=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/UserServiceIntegrationTest.java    |  39 +++++++
 .../interfaces/api/UserV1ApiE2ETest.java      | 107 ++++++++++++++++++
 2 files changed, 146 insertions(+)

diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
index 8951953b..c8b9fc54 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
@@ -1,9 +1,12 @@
 package com.loopers.domain;
 
 import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
 import static org.junit.jupiter.api.Assertions.assertAll;
 
 import com.loopers.infrastructure.UserJpaRepository;
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
 import com.loopers.utils.DatabaseCleanUp;
 import java.time.LocalDate;
 import org.junit.jupiter.api.AfterEach;
@@ -65,4 +68,40 @@ void signup_whenAllInfoProvided() {
                 );
             }
     }
+
+    @DisplayName("유저가 내 정보를 조회할 때")
+    @Nested
+    class GetMyInfo {
+        @DisplayName("로그인 ID로 내 정보를 조회한다")
+        @Test
+        void getMyInfo_whenValidLoginId() {
+            // arrange
+            userService.signup(validLoginId, validPassword, validName, validBirthDate, validEmail);
+
+            // act
+            UserModel result = userService.getMyInfo(validLoginId);
+
+            // assert
+            assertAll(
+                () -> assertThat(result).isNotNull(),
+                () -> assertThat(result.getLoginId()).isEqualTo(validLoginId),
+                () -> assertThat(result.getName()).isEqualTo(validName),
+                () -> assertThat(result.getBirthDate()).isEqualTo(validBirthDate),
+                () -> assertThat(result.getEmail()).isEqualTo(validEmail)
+            );
+        }
+
+        @DisplayName("존재하지 않는 로그인 ID로 조회하면 예외가 발생한다")
+        @Test
+        void getMyInfo_whenInvalidLoginId() {
+            // arrange
+            LoginId invalidLoginId = new LoginId("invalid123");
+
+            // act & assert
+            assertThatThrownBy(() -> userService.getMyInfo(invalidLoginId))
+                .isInstanceOf(CoreException.class)
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.NOT_FOUND)
+                .hasMessageContaining("사용자를 찾을 수 없습니다.");
+        }
+    }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
index dad89be6..9355bbd9 100644
--- a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
@@ -337,4 +337,111 @@ void throwsBadRequest_whenNameIsTooLong() {
             );
         }
     }
+
+    @DisplayName("GET /api/v1/users/me")
+    @Nested
+    class GetMyInfo {
+
+        private static final String ENDPOINT_MY_INFO = "/api/v1/users/me";
+        private static final String HEADER_LOGIN_ID = "X-Loopers-LoginId";
+        private static final String HEADER_LOGIN_PW = "X-Loopers-LoginPw";
+
+        @DisplayName("유효한 인증 헤더로 내 정보를 조회하면, 사용자 정보를 반환한다")
+        @Test
+        void returnsMyInfo_whenValidAuthenticationHeaders() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            // act
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.MyInfoResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is2xxSuccessful()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK),
+                () -> assertThat(response.getBody().data().loginId()).isEqualTo("testuser1"),
+                () -> assertThat(response.getBody().data().name()).isEqualTo("홍길*"),
+                () -> assertThat(response.getBody().data().birthDate()).isEqualTo("19900101"),
+                () -> assertThat(response.getBody().data().email()).isEqualTo("test@example.com")
+            );
+        }
+
+        @DisplayName("존재하지 않는 로그인 ID로 조회하면, 401 UNAUTHORIZED 응답을 받는다")
+        @Test
+        void throwsUnauthorized_whenUserNotFound() {
+            // arrange
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "nonexistent");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.MyInfoResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.UNAUTHORIZED)
+            );
+        }
+
+        @DisplayName("잘못된 비밀번호로 조회하면, 401 UNAUTHORIZED 응답을 받는다")
+        @Test
+        void throwsUnauthorized_whenPasswordIsIncorrect() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Wrong1234!");
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.MyInfoResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.UNAUTHORIZED)
+            );
+        }
+
+        @DisplayName("인증 헤더가 없으면, 4xx 에러 응답을 받는다")
+        @Test
+        void throwsError_whenAuthenticationHeadersMissing() {
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.MyInfoResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, null, responseType);
+
+            // assert
+            assertTrue(response.getStatusCode().is4xxClientError() || response.getStatusCode().is5xxServerError());
+        }
+    }
 }

From 5f11aef8896d2c6221d64ef882bac6967cbcbce2 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 00:29:49 +0900
Subject: [PATCH 19/29] =?UTF-8?q?docs:=20=EB=82=B4=20=EC=A0=95=EB=B3=B4=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20API=20HTTP=20=ED=85=8C=EC=8A=A4=ED=8A=B8?=
 =?UTF-8?q?=20=EC=BC=80=EC=9D=B4=EC=8A=A4=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 http/commerce-api/user-v1.http | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/http/commerce-api/user-v1.http b/http/commerce-api/user-v1.http
index 58ee4cb9..d16889d0 100644
--- a/http/commerce-api/user-v1.http
+++ b/http/commerce-api/user-v1.http
@@ -129,3 +129,25 @@ Content-Type: application/json
   "birthDate": "19950505",
   "email": "test2@example.com"
 }
+
+###############################################
+# 내 정보 조회 API
+###############################################
+
+### 내 정보 조회 - 성공 케이스
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+
+### 내 정보 조회 - 존재하지 않는 로그인 ID (실패)
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: nonexistent
+X-Loopers-LoginPw: Test1234!
+
+### 내 정보 조회 - 잘못된 비밀번호 (실패)
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Wrong1234!
+
+### 내 정보 조회 - 인증 헤더 누락 (실패)
+GET {{commerce-api}}/api/v1/users/me

From 09bbbe19accd332f08253a9a5b77b3779bb9dded Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:02 +0900
Subject: [PATCH 20/29] =?UTF-8?q?feat:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20=EB=8F=84=EB=A9=94=EC=9D=B8=20?=
 =?UTF-8?q?=EB=A1=9C=EC=A7=81=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../src/main/java/com/loopers/domain/UserModel.java   | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
index 679704fd..931e95e6 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
@@ -61,4 +61,15 @@ private void validateNotNull(Object value, String fieldName) {
             throw new CoreException(ErrorType.BAD_REQUEST,fieldName + "은(는) 필수 입력값입니다.");
         }
     }
+
+    public void changePassword(Password currentPassword, Password newPassword) {
+        if (!this.password.equals(currentPassword)) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "현재 비밀번호가 일치하지 않습니다.");
+        }
+
+        newPassword.validateNotSameAs(currentPassword);
+        newPassword.validateNotContainBirthday(this.birthDate);
+
+        this.password = newPassword;
+    }
 }

From ec973bae17485c9ba296b71c9ec1edd29205c6a8 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:02 +0900
Subject: [PATCH 21/29] =?UTF-8?q?feat:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20=EC=84=9C=EB=B9=84=EC=8A=A4=20?=
 =?UTF-8?q?=EB=A1=9C=EC=A7=81=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../src/main/java/com/loopers/domain/UserService.java    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
index 72a0fd2f..79dda8b7 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
@@ -27,4 +27,13 @@ public UserModel getMyInfo(LoginId loginId) {
         return userRepository.find(loginId)
             .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "사용자를 찾을 수 없습니다."));
     }
+
+    @Transactional
+    public void changePassword(LoginId loginId, Password currentPassword, Password newPassword) {
+        UserModel user = userRepository.find(loginId)
+            .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "사용자를 찾을 수 없습니다."));
+
+        user.changePassword(currentPassword, newPassword);
+        userRepository.save(user);
+    }
 }

From 46d8afeb8671588b9c9e7431469f6d1709af50b6 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:03 +0900
Subject: [PATCH 22/29] =?UTF-8?q?feat:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20API=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../interfaces/api/user/UserV1ApiSpec.java    | 13 ++++++++++++
 .../interfaces/api/user/UserV1Controller.java | 17 +++++++++++++++
 .../interfaces/api/user/UserV1Dto.java        | 21 +++++++++++++++++++
 3 files changed, 51 insertions(+)

diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
index 1be37d4a..b3d0743c 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1ApiSpec.java
@@ -28,4 +28,17 @@ ApiResponse<UserV1Dto.MyInfoResponse> getMyInfo(
         @Parameter(description = "비밀번호", required = true)
         String password
     );
+
+    @Operation(
+        summary = "비밀번호 변경",
+        description = "인증된 사용자의 비밀번호를 변경합니다. 헤더에 X-Loopers-LoginId와 X-Loopers-LoginPw를 포함해야 합니다."
+    )
+    ApiResponse<UserV1Dto.ChangePasswordResponse> changePassword(
+        @Parameter(description = "로그인 ID", required = true)
+        String loginId,
+        @Parameter(description = "현재 비밀번호", required = true)
+        String currentPassword,
+        @RequestBody(description = "비밀번호 변경 요청 정보")
+        UserV1Dto.ChangePasswordRequest request
+    );
 }
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
index e97600d9..2f715515 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Controller.java
@@ -50,4 +50,21 @@ public ApiResponse<UserV1Dto.MyInfoResponse> getMyInfo(
 
         return ApiResponse.success(response);
     }
+
+    @PatchMapping("/password")
+    @Override
+    public ApiResponse<UserV1Dto.ChangePasswordResponse> changePassword(
+        @RequestHeader(HEADER_LOGIN_ID) String loginId,
+        @RequestHeader(HEADER_LOGIN_PW) String currentPasswordValue,
+        @Valid @RequestBody UserV1Dto.ChangePasswordRequest request
+    ) {
+        UserModel authenticatedUser = authenticationService.authenticate(loginId, currentPasswordValue);
+
+        Password currentPassword = new Password(request.currentPassword());
+        Password newPassword = new Password(request.newPassword());
+
+        userService.changePassword(authenticatedUser.getLoginId(), currentPassword, newPassword);
+
+        return ApiResponse.success(UserV1Dto.ChangePasswordResponse.success());
+    }
 }
diff --git a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
index 29429429..7daae480 100644
--- a/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
+++ b/apps/commerce-api/src/main/java/com/loopers/interfaces/api/user/UserV1Dto.java
@@ -68,4 +68,25 @@ public static MyInfoResponse from(UserModel model) {
             );
         }
     }
+
+    public record ChangePasswordRequest(
+        @NotBlank(message = "현재 비밀번호는 필수 입력값입니다.")
+        String currentPassword,
+
+        @NotBlank(message = "새 비밀번호는 필수 입력값입니다.")
+        @Pattern(
+            regexp = "^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[~!@#$%^&*()_+=-])[A-Za-z\\d~!@#$%^&*()_+=-]{8,16}$",
+            message = "비밀번호는 8~16자의 영문 대소문자, 숫자, 특수문자 조합이어야 합니다."
+        )
+        String newPassword
+    ) {
+    }
+
+    public record ChangePasswordResponse(
+        String message
+    ) {
+        public static ChangePasswordResponse success() {
+            return new ChangePasswordResponse("비밀번호가 성공적으로 변경되었습니다.");
+        }
+    }
 }

From ec29637752eeba409d480758365311b746704068 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:04 +0900
Subject: [PATCH 23/29] =?UTF-8?q?test:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20=EB=8B=A8=EC=9C=84=20=ED=85=8C?=
 =?UTF-8?q?=EC=8A=A4=ED=8A=B8=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../com/loopers/domain/UserModelTest.java     | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
index fb0f36b4..9e6fda09 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
@@ -95,4 +95,66 @@ void createUserModel_whenPasswordContainsBirthDate() {
                     .isInstanceOf(CoreException.class);
         }
     }
+
+    @DisplayName("비밀번호를 변경할 때, ")
+    @Nested
+    class ChangePassword {
+
+        private UserModel user;
+
+        @BeforeEach
+        void setUp() {
+            user = new UserModel(validLoginId, validPassword, validName, validBirthDate, validEmail);
+        }
+
+        @DisplayName("올바른 현재 비밀번호와 새 비밀번호를 주면, 비밀번호가 변경된다.")
+        @Test
+        void changePassword_whenValidPasswords() {
+            // arrange
+            Password newPassword = new Password("NewPass123!@");
+
+            // act
+            user.changePassword(validPassword, newPassword);
+
+            // assert
+            assertThat(user.getPassword()).isEqualTo(newPassword);
+        }
+
+        @DisplayName("현재 비밀번호가 일치하지 않으면 예외가 발생한다.")
+        @Test
+        void changePassword_whenCurrentPasswordNotMatch() {
+            // arrange
+            Password wrongPassword = new Password("Wrong123!@#");
+            Password newPassword = new Password("NewPass123!@");
+
+            // act & assert
+            assertThatThrownBy(() -> user.changePassword(wrongPassword, newPassword))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("현재 비밀번호가 일치하지 않습니다.");
+        }
+
+        @DisplayName("새 비밀번호가 현재 비밀번호와 동일하면 예외가 발생한다.")
+        @Test
+        void changePassword_whenNewPasswordSameAsCurrent() {
+            // arrange
+            Password samePassword = new Password("Test1234!@#");
+
+            // act & assert
+            assertThatThrownBy(() -> user.changePassword(validPassword, samePassword))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("현재 사용 중인 비밀번호는 사용할 수 없습니다.");
+        }
+
+        @DisplayName("새 비밀번호에 생년월일이 포함되면 예외가 발생한다.")
+        @Test
+        void changePassword_whenNewPasswordContainsBirthDate() {
+            // arrange
+            Password newPasswordWithBirthDate = new Password("Pw19900115!");
+
+            // act & assert
+            assertThatThrownBy(() -> user.changePassword(validPassword, newPasswordWithBirthDate))
+                    .isInstanceOf(CoreException.class)
+                    .hasMessageContaining("생년월일은 비밀번호 내에 포함될 수 없습니다.");
+        }
+    }
 }

From b6350d40792e67bea2b84294cdcfcf16d61dd6dd Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:04 +0900
Subject: [PATCH 24/29] =?UTF-8?q?test:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20=ED=86=B5=ED=95=A9=20=ED=85=8C?=
 =?UTF-8?q?=EC=8A=A4=ED=8A=B8=20=EB=B0=8F=20E2E=20=ED=85=8C=EC=8A=A4?=
 =?UTF-8?q?=ED=8A=B8=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../domain/UserServiceIntegrationTest.java    |  73 ++++++
 .../interfaces/api/UserV1ApiE2ETest.java      | 232 ++++++++++++++++++
 2 files changed, 305 insertions(+)

diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
index c8b9fc54..9b9f538d 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
@@ -104,4 +104,77 @@ void getMyInfo_whenInvalidLoginId() {
                 .hasMessageContaining("사용자를 찾을 수 없습니다.");
         }
     }
+
+    @DisplayName("유저가 비밀번호를 변경할 때")
+    @Nested
+    class ChangePassword {
+        @DisplayName("올바른 현재 비밀번호와 새 비밀번호를 주면 비밀번호가 변경된다")
+        @Test
+        void changePassword_whenValidPasswords() {
+            // arrange
+            userService.signup(validLoginId, validPassword, validName, validBirthDate, validEmail);
+            Password newPassword = new Password("NewPass123!@");
+
+            // act
+            userService.changePassword(validLoginId, validPassword, newPassword);
+
+            // assert
+            UserModel updatedUser = userService.getMyInfo(validLoginId);
+            assertThat(updatedUser.getPassword()).isEqualTo(newPassword);
+        }
+
+        @DisplayName("현재 비밀번호가 일치하지 않으면 예외가 발생한다")
+        @Test
+        void changePassword_whenCurrentPasswordNotMatch() {
+            // arrange
+            userService.signup(validLoginId, validPassword, validName, validBirthDate, validEmail);
+            Password wrongPassword = new Password("Wrong123!@#");
+            Password newPassword = new Password("NewPass123!@");
+
+            // act & assert
+            assertThatThrownBy(() -> userService.changePassword(validLoginId, wrongPassword, newPassword))
+                .isInstanceOf(CoreException.class)
+                .hasMessageContaining("현재 비밀번호가 일치하지 않습니다.");
+        }
+
+        @DisplayName("새 비밀번호가 현재 비밀번호와 동일하면 예외가 발생한다")
+        @Test
+        void changePassword_whenNewPasswordSameAsCurrent() {
+            // arrange
+            userService.signup(validLoginId, validPassword, validName, validBirthDate, validEmail);
+            Password samePassword = new Password("Test1234!@#");
+
+            // act & assert
+            assertThatThrownBy(() -> userService.changePassword(validLoginId, validPassword, samePassword))
+                .isInstanceOf(CoreException.class)
+                .hasMessageContaining("현재 사용 중인 비밀번호는 사용할 수 없습니다.");
+        }
+
+        @DisplayName("새 비밀번호에 생년월일이 포함되면 예외가 발생한다")
+        @Test
+        void changePassword_whenNewPasswordContainsBirthDate() {
+            // arrange
+            userService.signup(validLoginId, validPassword, validName, validBirthDate, validEmail);
+            Password newPasswordWithBirthDate = new Password("Pw19900115!");
+
+            // act & assert
+            assertThatThrownBy(() -> userService.changePassword(validLoginId, validPassword, newPasswordWithBirthDate))
+                .isInstanceOf(CoreException.class)
+                .hasMessageContaining("생년월일은 비밀번호 내에 포함될 수 없습니다.");
+        }
+
+        @DisplayName("존재하지 않는 사용자의 비밀번호 변경 시 예외가 발생한다")
+        @Test
+        void changePassword_whenUserNotFound() {
+            // arrange
+            LoginId invalidLoginId = new LoginId("invalid123");
+            Password newPassword = new Password("NewPass123!@");
+
+            // act & assert
+            assertThatThrownBy(() -> userService.changePassword(invalidLoginId, validPassword, newPassword))
+                .isInstanceOf(CoreException.class)
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.NOT_FOUND)
+                .hasMessageContaining("사용자를 찾을 수 없습니다.");
+        }
+    }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
index 9355bbd9..c81b0f5b 100644
--- a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiE2ETest.java
@@ -444,4 +444,236 @@ void throwsError_whenAuthenticationHeadersMissing() {
             assertTrue(response.getStatusCode().is4xxClientError() || response.getStatusCode().is5xxServerError());
         }
     }
+
+    @DisplayName("PATCH /api/v1/users/password")
+    @Nested
+    class ChangePassword {
+
+        private static final String ENDPOINT_CHANGE_PASSWORD = "/api/v1/users/password";
+        private static final String HEADER_LOGIN_ID = "X-Loopers-LoginId";
+        private static final String HEADER_LOGIN_PW = "X-Loopers-LoginPw";
+
+        @DisplayName("유효한 인증 헤더와 비밀번호로 변경하면, 비밀번호가 변경된다")
+        @Test
+        void changePassword_whenValidRequest() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Test1234!",
+                "NewPass123!@"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is2xxSuccessful()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK),
+                () -> assertThat(response.getBody().data().message()).isEqualTo("비밀번호가 성공적으로 변경되었습니다.")
+            );
+        }
+
+        @DisplayName("현재 비밀번호가 일치하지 않으면, 400 BAD_REQUEST 응답을 받는다")
+        @Test
+        void changePassword_whenCurrentPasswordNotMatch() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Wrong1234!",
+                "NewPass123!@"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST)
+            );
+        }
+
+        @DisplayName("새 비밀번호가 현재 비밀번호와 동일하면, 400 BAD_REQUEST 응답을 받는다")
+        @Test
+        void changePassword_whenNewPasswordSameAsCurrent() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Test1234!",
+                "Test1234!"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST)
+            );
+        }
+
+        @DisplayName("새 비밀번호에 생년월일이 포함되면, 400 BAD_REQUEST 응답을 받는다")
+        @Test
+        void changePassword_whenNewPasswordContainsBirthDate() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Test1234!",
+                "Pw19900101!"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST)
+            );
+        }
+
+        @DisplayName("잘못된 인증 헤더로 요청하면, 401 UNAUTHORIZED 응답을 받는다")
+        @Test
+        void changePassword_whenUnauthorized() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Wrong1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Test1234!",
+                "NewPass123!@"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.UNAUTHORIZED)
+            );
+        }
+
+        @DisplayName("새 비밀번호 형식이 잘못되면, 400 BAD_REQUEST 응답을 받는다")
+        @Test
+        void changePassword_whenInvalidPasswordFormat() {
+            // arrange
+            UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+                "testuser1",
+                "Test1234!",
+                "홍길동",
+                "19900101",
+                "test@example.com"
+            );
+
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType = new ParameterizedTypeReference<>() {};
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+            org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders();
+            headers.set(HEADER_LOGIN_ID, "testuser1");
+            headers.set(HEADER_LOGIN_PW, "Test1234!");
+            headers.setContentType(org.springframework.http.MediaType.APPLICATION_JSON);
+
+            UserV1Dto.ChangePasswordRequest request = new UserV1Dto.ChangePasswordRequest(
+                "Test1234!",
+                "short"
+            );
+
+            // act
+            ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> responseType = new ParameterizedTypeReference<>() {};
+            ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> response =
+                testRestTemplate.exchange(ENDPOINT_CHANGE_PASSWORD, HttpMethod.PATCH, new HttpEntity<>(request, headers), responseType);
+
+            // assert
+            assertAll(
+                () -> assertTrue(response.getStatusCode().is4xxClientError()),
+                () -> assertThat(response.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST)
+            );
+        }
+    }
 }

From 641e21b5aa4bb25584f7003fc1c4137b9b0d37c0 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:29:05 +0900
Subject: [PATCH 25/29] =?UTF-8?q?docs:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20API=20HTTP=20=ED=85=8C?=
 =?UTF-8?q?=EC=8A=A4=ED=8A=B8=20=EC=BC=80=EC=9D=B4=EC=8A=A4=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 http/commerce-api/user-v1.http | 70 ++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/http/commerce-api/user-v1.http b/http/commerce-api/user-v1.http
index d16889d0..b68ce780 100644
--- a/http/commerce-api/user-v1.http
+++ b/http/commerce-api/user-v1.http
@@ -151,3 +151,73 @@ X-Loopers-LoginPw: Wrong1234!
 
 ### 내 정보 조회 - 인증 헤더 누락 (실패)
 GET {{commerce-api}}/api/v1/users/me
+
+###############################################
+# 비밀번호 변경 API
+###############################################
+
+### 비밀번호 변경 - 성공 케이스
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!",
+  "newPassword": "NewPass123!@"
+}
+
+### 비밀번호 변경 - 현재 비밀번호 불일치 (실패)
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Wrong1234!",
+  "newPassword": "NewPass123!@"
+}
+
+### 비밀번호 변경 - 새 비밀번호가 현재 비밀번호와 동일 (실패)
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!",
+  "newPassword": "Test1234!"
+}
+
+### 비밀번호 변경 - 새 비밀번호에 생년월일 포함 (실패)
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!",
+  "newPassword": "Pw19900101!"
+}
+
+### 비밀번호 변경 - 잘못된 인증 헤더 (실패)
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Wrong1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!",
+  "newPassword": "NewPass123!@"
+}
+
+### 비밀번호 변경 - 새 비밀번호 형식 오류 (실패)
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: testuser1
+X-Loopers-LoginPw: Test1234!
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!",
+  "newPassword": "short"
+}

From 521127d486fdf48853f8f1b279c96017e5b60298 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 03:52:44 +0900
Subject: [PATCH 26/29] =?UTF-8?q?test:=20=ED=9A=8C=EC=9B=90=EA=B0=80?=
 =?UTF-8?q?=EC=9E=85-=EB=82=B4=EC=A0=95=EB=B3=B4=EC=A1=B0=ED=9A=8C-?=
 =?UTF-8?q?=EB=B9=84=EB=B0=80=EB=B2=88=ED=98=B8=EB=B3=80=EA=B2=BD-?=
 =?UTF-8?q?=EB=82=B4=EC=A0=95=EB=B3=B4=EC=A1=B0=ED=9A=8C=20=EC=8B=9C?=
 =?UTF-8?q?=EB=82=98=EB=A6=AC=EC=98=A4=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../interfaces/api/UserV1ApiScenarioTest.java | 171 ++++++++++++++++++
 http/commerce-api/user-v1.http                |  42 +++++
 2 files changed, 213 insertions(+)
 create mode 100644 apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiScenarioTest.java

diff --git a/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiScenarioTest.java b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiScenarioTest.java
new file mode 100644
index 00000000..e15c7e65
--- /dev/null
+++ b/apps/commerce-api/src/test/java/com/loopers/interfaces/api/UserV1ApiScenarioTest.java
@@ -0,0 +1,171 @@
+package com.loopers.interfaces.api;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertAll;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.loopers.interfaces.api.user.UserV1Dto;
+import com.loopers.utils.DatabaseCleanUp;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.test.web.client.TestRestTemplate;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.http.HttpEntity;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpMethod;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+@DisplayName("User V1 API 시나리오 테스트")
+class UserV1ApiScenarioTest {
+
+    private static final String ENDPOINT_SIGNUP = "/api/v1/users/signup";
+    private static final String ENDPOINT_MY_INFO = "/api/v1/users/me";
+    private static final String ENDPOINT_CHANGE_PASSWORD = "/api/v1/users/password";
+    private static final String HEADER_LOGIN_ID = "X-Loopers-LoginId";
+    private static final String HEADER_LOGIN_PW = "X-Loopers-LoginPw";
+
+    private final TestRestTemplate testRestTemplate;
+    private final DatabaseCleanUp databaseCleanUp;
+
+    @Autowired
+    public UserV1ApiScenarioTest(
+        TestRestTemplate testRestTemplate,
+        DatabaseCleanUp databaseCleanUp
+    ) {
+        this.testRestTemplate = testRestTemplate;
+        this.databaseCleanUp = databaseCleanUp;
+    }
+
+    @AfterEach
+    void tearDown() {
+        databaseCleanUp.truncateAllTables();
+    }
+
+    @DisplayName("유저 전체 플로우: 회원가입 -> 내 정보 조회 -> 비밀번호 변경 -> 내 정보 조회")
+    @Test
+    void fullUserFlowScenario() {
+        String loginId = "testuser123";
+        String originalPassword = "Test1234!@#";
+        String newPassword = "NewPass123!@";
+        String name = "홍길동";
+        String birthDate = "19900115";
+        String email = "test@example.com";
+
+        // ===== 1단계: 회원가입 =====
+        UserV1Dto.SignupRequest signupRequest = new UserV1Dto.SignupRequest(
+            loginId,
+            originalPassword,
+            name,
+            birthDate,
+            email
+        );
+
+        ParameterizedTypeReference<ApiResponse<UserV1Dto.SignupResponse>> signupResponseType =
+            new ParameterizedTypeReference<>() {};
+        ResponseEntity<ApiResponse<UserV1Dto.SignupResponse>> signupResponse =
+            testRestTemplate.exchange(ENDPOINT_SIGNUP, HttpMethod.POST, new HttpEntity<>(signupRequest), signupResponseType);
+
+        // 회원가입 검증
+        assertAll(
+            "회원가입 성공 검증",
+            () -> assertTrue(signupResponse.getStatusCode().is2xxSuccessful()),
+            () -> assertThat(signupResponse.getStatusCode()).isEqualTo(HttpStatus.OK),
+            () -> assertThat(signupResponse.getBody()).isNotNull(),
+            () -> assertThat(signupResponse.getBody().data().loginId()).isEqualTo(loginId),
+            () -> assertThat(signupResponse.getBody().data().name()).isEqualTo("홍길*"),
+            () -> assertThat(signupResponse.getBody().data().birthDate()).isEqualTo(birthDate),
+            () -> assertThat(signupResponse.getBody().data().email()).isEqualTo(email)
+        );
+
+        // ===== 2단계: 내 정보 조회 (원래 비밀번호로) =====
+        HttpHeaders headers1 = new HttpHeaders();
+        headers1.set(HEADER_LOGIN_ID, loginId);
+        headers1.set(HEADER_LOGIN_PW, originalPassword);
+
+        ParameterizedTypeReference<ApiResponse<UserV1Dto.MyInfoResponse>> myInfoResponseType =
+            new ParameterizedTypeReference<>() {};
+        ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> myInfoResponse1 =
+            testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers1), myInfoResponseType);
+
+        // 첫 번째 내 정보 조회 검증
+        assertAll(
+            "첫 번째 내 정보 조회 성공 검증",
+            () -> assertTrue(myInfoResponse1.getStatusCode().is2xxSuccessful()),
+            () -> assertThat(myInfoResponse1.getStatusCode()).isEqualTo(HttpStatus.OK),
+            () -> assertThat(myInfoResponse1.getBody()).isNotNull(),
+            () -> assertThat(myInfoResponse1.getBody().data().loginId()).isEqualTo(loginId),
+            () -> assertThat(myInfoResponse1.getBody().data().name()).isEqualTo("홍길*"),
+            () -> assertThat(myInfoResponse1.getBody().data().birthDate()).isEqualTo(birthDate),
+            () -> assertThat(myInfoResponse1.getBody().data().email()).isEqualTo(email)
+        );
+
+        // ===== 3단계: 비밀번호 변경 =====
+        HttpHeaders headers2 = new HttpHeaders();
+        headers2.set(HEADER_LOGIN_ID, loginId);
+        headers2.set(HEADER_LOGIN_PW, originalPassword);
+
+        UserV1Dto.ChangePasswordRequest changePasswordRequest = new UserV1Dto.ChangePasswordRequest(
+            originalPassword,
+            newPassword
+        );
+
+        ParameterizedTypeReference<ApiResponse<UserV1Dto.ChangePasswordResponse>> changePasswordResponseType =
+            new ParameterizedTypeReference<>() {};
+        ResponseEntity<ApiResponse<UserV1Dto.ChangePasswordResponse>> changePasswordResponse =
+            testRestTemplate.exchange(
+                ENDPOINT_CHANGE_PASSWORD,
+                HttpMethod.PATCH,
+                new HttpEntity<>(changePasswordRequest, headers2),
+                changePasswordResponseType
+            );
+
+        // 비밀번호 변경 검증
+        assertAll(
+            "비밀번호 변경 성공 검증",
+            () -> assertTrue(changePasswordResponse.getStatusCode().is2xxSuccessful()),
+            () -> assertThat(changePasswordResponse.getStatusCode()).isEqualTo(HttpStatus.OK),
+            () -> assertThat(changePasswordResponse.getBody()).isNotNull(),
+            () -> assertThat(changePasswordResponse.getBody().data().message()).isEqualTo("비밀번호가 성공적으로 변경되었습니다.")
+        );
+
+        // ===== 4단계: 내 정보 조회 (새 비밀번호로) =====
+        HttpHeaders headers3 = new HttpHeaders();
+        headers3.set(HEADER_LOGIN_ID, loginId);
+        headers3.set(HEADER_LOGIN_PW, newPassword);
+
+        ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> myInfoResponse2 =
+            testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers3), myInfoResponseType);
+
+        // 두 번째 내 정보 조회 검증 (새 비밀번호로 인증 성공)
+        assertAll(
+            "새 비밀번호로 내 정보 조회 성공 검증",
+            () -> assertTrue(myInfoResponse2.getStatusCode().is2xxSuccessful()),
+            () -> assertThat(myInfoResponse2.getStatusCode()).isEqualTo(HttpStatus.OK),
+            () -> assertThat(myInfoResponse2.getBody()).isNotNull(),
+            () -> assertThat(myInfoResponse2.getBody().data().loginId()).isEqualTo(loginId),
+            () -> assertThat(myInfoResponse2.getBody().data().name()).isEqualTo("홍길*"),
+            () -> assertThat(myInfoResponse2.getBody().data().birthDate()).isEqualTo(birthDate),
+            () -> assertThat(myInfoResponse2.getBody().data().email()).isEqualTo(email)
+        );
+
+        // ===== 5단계: 이전 비밀번호로는 인증 실패 확인 =====
+        HttpHeaders headers4 = new HttpHeaders();
+        headers4.set(HEADER_LOGIN_ID, loginId);
+        headers4.set(HEADER_LOGIN_PW, originalPassword);
+
+        ResponseEntity<ApiResponse<UserV1Dto.MyInfoResponse>> myInfoResponse3 =
+            testRestTemplate.exchange(ENDPOINT_MY_INFO, HttpMethod.GET, new HttpEntity<>(headers4), myInfoResponseType);
+
+        // 이전 비밀번호로 인증 실패 검증
+        assertAll(
+            "이전 비밀번호로 인증 실패 검증",
+            () -> assertTrue(myInfoResponse3.getStatusCode().is4xxClientError()),
+            () -> assertThat(myInfoResponse3.getStatusCode()).isEqualTo(HttpStatus.UNAUTHORIZED)
+        );
+    }
+}
diff --git a/http/commerce-api/user-v1.http b/http/commerce-api/user-v1.http
index b68ce780..726e819a 100644
--- a/http/commerce-api/user-v1.http
+++ b/http/commerce-api/user-v1.http
@@ -221,3 +221,45 @@ Content-Type: application/json
   "currentPassword": "Test1234!",
   "newPassword": "short"
 }
+
+###############################################
+# 시나리오 테스트 (전체 플로우)
+###############################################
+
+### [STEP 1] 회원가입 - 시나리오 테스트용 사용자
+POST {{commerce-api}}/api/v1/users/signup
+Content-Type: application/json
+
+{
+  "loginId": "scenario123",
+  "password": "Test1234!@#",
+  "name": "홍길동",
+  "birthDate": "19900115",
+  "email": "scenario@example.com"
+}
+
+### [STEP 2] 내 정보 조회 - 원래 비밀번호로 인증
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: scenario123
+X-Loopers-LoginPw: Test1234!@#
+
+### [STEP 3] 비밀번호 변경
+PATCH {{commerce-api}}/api/v1/users/password
+X-Loopers-LoginId: scenario123
+X-Loopers-LoginPw: Test1234!@#
+Content-Type: application/json
+
+{
+  "currentPassword": "Test1234!@#",
+  "newPassword": "NewPass123!@"
+}
+
+### [STEP 4] 내 정보 조회 - 새 비밀번호로 인증 (성공)
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: scenario123
+X-Loopers-LoginPw: NewPass123!@
+
+### [STEP 5] 내 정보 조회 - 이전 비밀번호로 인증 (실패)
+GET {{commerce-api}}/api/v1/users/me
+X-Loopers-LoginId: scenario123
+X-Loopers-LoginPw: Test1234!@#

From 3b3ef73939547cf9e92d3e8b21ef41c1b7adbdb9 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 11:56:42 +0900
Subject: [PATCH 27/29] =?UTF-8?q?feat:=20=ED=8C=A8=EC=8A=A4=EC=9B=8C?=
 =?UTF-8?q?=EB=93=9C=20=EC=95=94=ED=98=B8=ED=99=94=20=EA=B8=B0=EB=8A=A5=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- PasswordEncoder 인터페이스 및 BCrypt 구현체 추가
- Password.fromEncoded() 메서드 추가
- UserService에서 회원가입 시 패스워드 암호화
- AuthenticationService에서 암호화된 패스워드 비교
- 관련 테스트 코드 수정

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 apps/commerce-api/build.gradle.kts            |  3 ++
 .../loopers/domain/AuthenticationService.java |  5 ++-
 .../java/com/loopers/domain/Password.java     |  8 ++++
 .../java/com/loopers/domain/UserModel.java    |  2 -
 .../java/com/loopers/domain/UserService.java  |  9 ++++-
 .../BCryptPasswordEncoderImpl.java            | 24 +++++++++++
 .../infrastructure/PasswordEncoder.java       |  6 +++
 .../domain/AuthenticationServiceTest.java     | 17 ++++++--
 .../domain/UserServiceIntegrationTest.java    | 40 ++++++++++++++++++-
 9 files changed, 104 insertions(+), 10 deletions(-)
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/infrastructure/BCryptPasswordEncoderImpl.java
 create mode 100644 apps/commerce-api/src/main/java/com/loopers/infrastructure/PasswordEncoder.java

diff --git a/apps/commerce-api/build.gradle.kts b/apps/commerce-api/build.gradle.kts
index 03ce68f0..6acd8606 100644
--- a/apps/commerce-api/build.gradle.kts
+++ b/apps/commerce-api/build.gradle.kts
@@ -11,6 +11,9 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-actuator")
     implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:${project.properties["springDocOpenApiVersion"]}")
 
+    // security
+    implementation("org.springframework.security:spring-security-crypto")
+
     // querydsl
     annotationProcessor("com.querydsl:querydsl-apt::jakarta")
     annotationProcessor("jakarta.persistence:jakarta.persistence-api")
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java b/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java
index 97734843..bf148ae1 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/AuthenticationService.java
@@ -1,5 +1,6 @@
 package com.loopers.domain;
 
+import com.loopers.infrastructure.PasswordEncoder;
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
 import lombok.RequiredArgsConstructor;
@@ -10,15 +11,15 @@
 public class AuthenticationService {
 
     private final UserRepository userRepository;
+    private final PasswordEncoder passwordEncoder;
 
     public UserModel authenticate(String loginIdValue, String rawPassword) {
         LoginId loginId = new LoginId(loginIdValue);
-        Password password = new Password(rawPassword);
 
         UserModel user = userRepository.find(loginId)
             .orElseThrow(() -> new CoreException(ErrorType.UNAUTHORIZED, "로그인 ID 또는 비밀번호가 일치하지 않습니다."));
 
-        if (!user.getPassword().equals(password)) {
+        if (!passwordEncoder.matches(rawPassword, user.getPassword().getValue())) {
             throw new CoreException(ErrorType.UNAUTHORIZED, "로그인 ID 또는 비밀번호가 일치하지 않습니다.");
         }
 
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
index 25143cf1..17d4ec1d 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/Password.java
@@ -22,6 +22,14 @@ public Password(String value) {
         this.value = value;
     }
 
+    private Password(String value, boolean skipValidation) {
+        this.value = value;
+    }
+
+    public static Password fromEncoded(String encodedValue) {
+        return new Password(encodedValue, true);
+    }
+
     private void validate(String value) {
         if (value == null || !PASSWORD_PATTERN.matcher(value).matches()) {
             throw new CoreException(ErrorType.BAD_REQUEST, "비밀번호는 8~16자의 영문 대소문자, 숫자, 특수문자 조합이어야 합니다.");
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
index 931e95e6..963eca96 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
@@ -53,8 +53,6 @@ private void validate(LoginId loginId, Password password, Name name, BirthDate b
         validateNotNull(name, "이름");
         validateNotNull(birthDate, "생년월일");
         validateNotNull(email, "이메일");
-
-        password.validateNotContainBirthday(birthDate);
     }
     private void validateNotNull(Object value, String fieldName) {
         if (value == null) {
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
index 79dda8b7..0cd79b6f 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
@@ -1,5 +1,6 @@
 package com.loopers.domain;
 
+import com.loopers.infrastructure.PasswordEncoder;
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
 import jakarta.transaction.Transactional;
@@ -10,6 +11,7 @@
 @RequiredArgsConstructor
 public class UserService {
     private final UserRepository userRepository;
+    private final PasswordEncoder passwordEncoder;
 
     @Transactional
     public UserModel signup(LoginId loginId, Password password, Name name, BirthDate birthDate, Email email) {
@@ -18,7 +20,12 @@ public UserModel signup(LoginId loginId, Password password, Name name, BirthDate
             throw new CoreException(ErrorType.BAD_REQUEST,"이미 존재하는 아이디입니다.");
         }
 
-        UserModel userModel = new UserModel(loginId,password,name,birthDate,email);
+        password.validateNotContainBirthday(birthDate);
+
+        String encodedPasswordValue = passwordEncoder.encode(password.getValue());
+        Password encryptedPassword = Password.fromEncoded(encodedPasswordValue);
+
+        UserModel userModel = new UserModel(loginId,encryptedPassword,name,birthDate,email);
 
         return userRepository.save(userModel);
     }
diff --git a/apps/commerce-api/src/main/java/com/loopers/infrastructure/BCryptPasswordEncoderImpl.java b/apps/commerce-api/src/main/java/com/loopers/infrastructure/BCryptPasswordEncoderImpl.java
new file mode 100644
index 00000000..6545f186
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/infrastructure/BCryptPasswordEncoderImpl.java
@@ -0,0 +1,24 @@
+package com.loopers.infrastructure;
+
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+import org.springframework.stereotype.Component;
+
+@Component
+public class BCryptPasswordEncoderImpl implements PasswordEncoder {
+
+    private final BCryptPasswordEncoder delegate;
+
+    public BCryptPasswordEncoderImpl() {
+        this.delegate = new BCryptPasswordEncoder();
+    }
+
+    @Override
+    public String encode(String rawPassword) {
+        return delegate.encode(rawPassword);
+    }
+
+    @Override
+    public boolean matches(String rawPassword, String encodedPassword) {
+        return delegate.matches(rawPassword, encodedPassword);
+    }
+}
diff --git a/apps/commerce-api/src/main/java/com/loopers/infrastructure/PasswordEncoder.java b/apps/commerce-api/src/main/java/com/loopers/infrastructure/PasswordEncoder.java
new file mode 100644
index 00000000..fbe0ff62
--- /dev/null
+++ b/apps/commerce-api/src/main/java/com/loopers/infrastructure/PasswordEncoder.java
@@ -0,0 +1,6 @@
+package com.loopers.infrastructure;
+
+public interface PasswordEncoder {
+    String encode(String rawPassword);
+    boolean matches(String rawPassword, String encodedPassword);
+}
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java
index 234ba177..1cf99940 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/AuthenticationServiceTest.java
@@ -25,21 +25,26 @@ class AuthenticationServiceTest {
     @Mock
     private UserRepository userRepository;
 
+    @Mock
+    private com.loopers.infrastructure.PasswordEncoder passwordEncoder;
+
     @InjectMocks
     private AuthenticationService authenticationService;
 
     private UserModel testUser;
     private String validLoginId;
     private String validPassword;
+    private String encodedPassword;
 
     @BeforeEach
     void setUp() {
         validLoginId = "testuser123";
         validPassword = "Test1234!@#";
+        encodedPassword = "$2a$10$encodedPasswordHash";
 
         testUser = new UserModel(
             new LoginId(validLoginId),
-            new Password(validPassword),
+            Password.fromEncoded(encodedPassword),
             new Name("홍길동"),
             new BirthDate(LocalDate.of(1990, 1, 15)),
             new Email("test@example.com")
@@ -55,6 +60,7 @@ class Authenticate {
         void authenticate_should_return_user_when_credentials_are_correct() {
             // arrange
             when(userRepository.find(any(LoginId.class))).thenReturn(Optional.of(testUser));
+            when(passwordEncoder.matches(validPassword, encodedPassword)).thenReturn(true);
 
             // act
             UserModel result = authenticationService.authenticate(validLoginId, validPassword);
@@ -83,6 +89,7 @@ void authenticate_should_throw_exception_when_password_is_incorrect() {
             // arrange
             when(userRepository.find(any(LoginId.class))).thenReturn(Optional.of(testUser));
             String wrongPassword = "Wrong1234!@#";
+            when(passwordEncoder.matches(wrongPassword, encodedPassword)).thenReturn(false);
 
             // act & assert
             assertThatThrownBy(() -> authenticationService.authenticate(validLoginId, wrongPassword))
@@ -92,12 +99,16 @@ void authenticate_should_throw_exception_when_password_is_incorrect() {
         }
 
         @Test
-        @DisplayName("비밀번호가 null이면 BAD_REQUEST 예외를 던진다")
+        @DisplayName("비밀번호가 null이면 UNAUTHORIZED 예외를 던진다")
         void authenticate_should_throw_exception_when_password_is_null() {
+            // arrange
+            when(userRepository.find(any(LoginId.class))).thenReturn(Optional.of(testUser));
+            when(passwordEncoder.matches(null, encodedPassword)).thenReturn(false);
+
             // act & assert
             assertThatThrownBy(() -> authenticationService.authenticate(validLoginId, null))
                 .isInstanceOf(CoreException.class)
-                .hasFieldOrPropertyWithValue("errorType", ErrorType.BAD_REQUEST);
+                .hasFieldOrPropertyWithValue("errorType", ErrorType.UNAUTHORIZED);
         }
     }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
index 9b9f538d..a272c114 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
@@ -4,6 +4,7 @@
 import static org.assertj.core.api.Assertions.assertThatThrownBy;
 import static org.junit.jupiter.api.Assertions.assertAll;
 
+import com.loopers.infrastructure.PasswordEncoder;
 import com.loopers.infrastructure.UserJpaRepository;
 import com.loopers.support.error.CoreException;
 import com.loopers.support.error.ErrorType;
@@ -25,11 +26,15 @@ public class UserServiceIntegrationTest {
     @Autowired
     private UserJpaRepository userJpaRepository;
 
+    @Autowired
+    private PasswordEncoder passwordEncoder;
+
     @Autowired
     private DatabaseCleanUp databaseCleanUp;
 
     private LoginId validLoginId;
     private Password validPassword;
+    private String rawPassword;
     private Name validName;
     private BirthDate validBirthDate;
     private Email validEmail;
@@ -37,7 +42,8 @@ public class UserServiceIntegrationTest {
     @BeforeEach
     void setUp() {
         validLoginId = new LoginId("testuser123");
-        validPassword = new Password("Test1234!@#");
+        rawPassword = "Test1234!@#";
+        validPassword = new Password(rawPassword);
         validName = new Name("홍길동");
         validBirthDate = new BirthDate(LocalDate.of(1990, 1, 15));
         validEmail = new Email("test@example.com");
@@ -61,12 +67,42 @@ void signup_whenAllInfoProvided() {
                 assertAll(
                         () -> assertThat(result).isNotNull(),
                         () -> assertThat(result.getLoginId()).isEqualTo(validLoginId),
-                        () -> assertThat(result.getPassword()).isEqualTo(validPassword),
                         () -> assertThat(result.getName()).isEqualTo(validName),
                         () -> assertThat(result.getBirthDate()).isEqualTo(validBirthDate),
                         () -> assertThat(result.getEmail()).isEqualTo(validEmail)
                 );
             }
+
+            @DisplayName("비밀번호를 암호화하여 저장한다")
+            @Test
+            void signup_should_encrypt_password() {
+                // act
+                UserModel result = userService.signup(validLoginId,validPassword,validName,validBirthDate,validEmail);
+
+                // assert
+                String savedPassword = result.getPassword().getValue();
+                assertAll(
+                        () -> assertThat(savedPassword).isNotEqualTo(rawPassword), // 평문과 다름
+                        () -> assertThat(savedPassword).startsWith("$2a$"), // BCrypt 포맷
+                        () -> assertThat(passwordEncoder.matches(rawPassword, savedPassword)).isTrue() // 평문과 매칭됨
+                );
+            }
+
+            @DisplayName("DB에 저장된 비밀번호가 암호화되어 있다")
+            @Test
+            void signup_should_save_encrypted_password_to_database() {
+                // act
+                UserModel result = userService.signup(validLoginId,validPassword,validName,validBirthDate,validEmail);
+
+                // assert
+                UserModel savedUser = userJpaRepository.findById(result.getId()).orElseThrow();
+                String savedPassword = savedUser.getPassword().getValue();
+                assertAll(
+                        () -> assertThat(savedPassword).isNotEqualTo(rawPassword), // 평문과 다름
+                        () -> assertThat(savedPassword).startsWith("$2a$"), // BCrypt 포맷
+                        () -> assertThat(passwordEncoder.matches(rawPassword, savedPassword)).isTrue() // 평문과 매칭됨
+                );
+            }
     }
 
     @DisplayName("유저가 내 정보를 조회할 때")

From fd18f15f502867ff5f5ff8a88b156ef9b376afe3 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 12:02:27 +0900
Subject: [PATCH 28/29] =?UTF-8?q?fix:=20=EB=B9=84=EB=B0=80=EB=B2=88?=
 =?UTF-8?q?=ED=98=B8=20=EB=B3=80=EA=B2=BD=20=EC=8B=9C=20=EC=95=94=ED=98=B8?=
 =?UTF-8?q?=ED=99=94=20=EC=A0=81=EC=9A=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- UserService에서 비밀번호 변경 시 암호화된 비밀번호와 비교
- 새 비밀번호도 암호화하여 저장
- UserModel.changePassword는 단순 필드 변경만 수행
- UserModelTest의 비밀번호 관련 테스트 제거 (로직이 UserService로 이동)
- UserServiceIntegrationTest 암호화를 고려한 검증으로 수정

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../java/com/loopers/domain/UserModel.java    |  8 +-
 .../java/com/loopers/domain/UserService.java  | 18 ++++-
 .../com/loopers/domain/UserModelTest.java     | 74 -------------------
 .../domain/UserServiceIntegrationTest.java    |  7 +-
 4 files changed, 24 insertions(+), 83 deletions(-)

diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
index 963eca96..4c76f23d 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserModel.java
@@ -61,13 +61,7 @@ private void validateNotNull(Object value, String fieldName) {
     }
 
     public void changePassword(Password currentPassword, Password newPassword) {
-        if (!this.password.equals(currentPassword)) {
-            throw new CoreException(ErrorType.BAD_REQUEST, "현재 비밀번호가 일치하지 않습니다.");
-        }
-
-        newPassword.validateNotSameAs(currentPassword);
-        newPassword.validateNotContainBirthday(this.birthDate);
-
+        // 검증은 UserService에서 수행
         this.password = newPassword;
     }
 }
diff --git a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
index 0cd79b6f..874c1f87 100644
--- a/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
+++ b/apps/commerce-api/src/main/java/com/loopers/domain/UserService.java
@@ -40,7 +40,23 @@ public void changePassword(LoginId loginId, Password currentPassword, Password n
         UserModel user = userRepository.find(loginId)
             .orElseThrow(() -> new CoreException(ErrorType.NOT_FOUND, "사용자를 찾을 수 없습니다."));
 
-        user.changePassword(currentPassword, newPassword);
+        // 현재 비밀번호 검증
+        if (!passwordEncoder.matches(currentPassword.getValue(), user.getPassword().getValue())) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "현재 비밀번호가 일치하지 않습니다.");
+        }
+
+        // 새 비밀번호 검증
+        if (passwordEncoder.matches(newPassword.getValue(), user.getPassword().getValue())) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "현재 사용 중인 비밀번호는 사용할 수 없습니다.");
+        }
+
+        newPassword.validateNotContainBirthday(user.getBirthDate());
+
+        // 새 비밀번호 암호화 및 저장
+        String encodedNewPassword = passwordEncoder.encode(newPassword.getValue());
+        Password encryptedNewPassword = Password.fromEncoded(encodedNewPassword);
+
+        user.changePassword(Password.fromEncoded(user.getPassword().getValue()), encryptedNewPassword);
         userRepository.save(user);
     }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
index 9e6fda09..6082a9ef 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserModelTest.java
@@ -82,79 +82,5 @@ void createUserModel_whenEmailIsNull() {
             assertThatThrownBy(() -> new UserModel(validLoginId, validPassword, validName, validBirthDate, null))
                     .isInstanceOf(CoreException.class);
         }
-
-        @DisplayName("비밀번호에 생년월일이 포함되면 예외가 발생한다.")
-        @Test
-        void createUserModel_whenPasswordContainsBirthDate() {
-            // arrange
-            BirthDate birthDate = new BirthDate(LocalDate.of(1990, 1, 15));
-            Password passwordWithBirthDate = new Password("Pw19900115!");
-
-            // expect
-            assertThatThrownBy(() -> new UserModel(validLoginId, passwordWithBirthDate, validName, birthDate, validEmail))
-                    .isInstanceOf(CoreException.class);
-        }
-    }
-
-    @DisplayName("비밀번호를 변경할 때, ")
-    @Nested
-    class ChangePassword {
-
-        private UserModel user;
-
-        @BeforeEach
-        void setUp() {
-            user = new UserModel(validLoginId, validPassword, validName, validBirthDate, validEmail);
-        }
-
-        @DisplayName("올바른 현재 비밀번호와 새 비밀번호를 주면, 비밀번호가 변경된다.")
-        @Test
-        void changePassword_whenValidPasswords() {
-            // arrange
-            Password newPassword = new Password("NewPass123!@");
-
-            // act
-            user.changePassword(validPassword, newPassword);
-
-            // assert
-            assertThat(user.getPassword()).isEqualTo(newPassword);
-        }
-
-        @DisplayName("현재 비밀번호가 일치하지 않으면 예외가 발생한다.")
-        @Test
-        void changePassword_whenCurrentPasswordNotMatch() {
-            // arrange
-            Password wrongPassword = new Password("Wrong123!@#");
-            Password newPassword = new Password("NewPass123!@");
-
-            // act & assert
-            assertThatThrownBy(() -> user.changePassword(wrongPassword, newPassword))
-                    .isInstanceOf(CoreException.class)
-                    .hasMessageContaining("현재 비밀번호가 일치하지 않습니다.");
-        }
-
-        @DisplayName("새 비밀번호가 현재 비밀번호와 동일하면 예외가 발생한다.")
-        @Test
-        void changePassword_whenNewPasswordSameAsCurrent() {
-            // arrange
-            Password samePassword = new Password("Test1234!@#");
-
-            // act & assert
-            assertThatThrownBy(() -> user.changePassword(validPassword, samePassword))
-                    .isInstanceOf(CoreException.class)
-                    .hasMessageContaining("현재 사용 중인 비밀번호는 사용할 수 없습니다.");
-        }
-
-        @DisplayName("새 비밀번호에 생년월일이 포함되면 예외가 발생한다.")
-        @Test
-        void changePassword_whenNewPasswordContainsBirthDate() {
-            // arrange
-            Password newPasswordWithBirthDate = new Password("Pw19900115!");
-
-            // act & assert
-            assertThatThrownBy(() -> user.changePassword(validPassword, newPasswordWithBirthDate))
-                    .isInstanceOf(CoreException.class)
-                    .hasMessageContaining("생년월일은 비밀번호 내에 포함될 수 없습니다.");
-        }
     }
 }
diff --git a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
index a272c114..67067309 100644
--- a/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
+++ b/apps/commerce-api/src/test/java/com/loopers/domain/UserServiceIntegrationTest.java
@@ -156,7 +156,12 @@ void changePassword_whenValidPasswords() {
 
             // assert
             UserModel updatedUser = userService.getMyInfo(validLoginId);
-            assertThat(updatedUser.getPassword()).isEqualTo(newPassword);
+            String savedPassword = updatedUser.getPassword().getValue();
+            assertAll(
+                    () -> assertThat(savedPassword).isNotEqualTo(rawPassword), // 이전 평문과 다름
+                    () -> assertThat(savedPassword).isNotEqualTo(newPassword.getValue()), // 새 평문과도 다름 (암호화됨)
+                    () -> assertThat(passwordEncoder.matches(newPassword.getValue(), savedPassword)).isTrue() // 새 비밀번호와 매칭됨
+            );
         }
 
         @DisplayName("현재 비밀번호가 일치하지 않으면 예외가 발생한다")

From 899e211f5e1110cc6d08754b3618f4d227f9b9d7 Mon Sep 17 00:00:00 2001
From: plan11plan <tjtfy7028@gmail.com>
Date: Fri, 6 Feb 2026 14:34:25 +0900
Subject: [PATCH 29/29] =?UTF-8?q?docs:=20=EA=B3=BC=EC=A0=9C=20=EC=A7=84?=
 =?UTF-8?q?=ED=96=89=20=EA=B3=BC=EC=A0=95=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 76 ++++++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 53 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 30d2f701..49ee650a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
-# Round-1  목표
+# Round-1 
+### 시작 전 목표
 ```
 - 나의 의도를 테스트 코드로 작성한다.
 - TDD 방식으로 AI와 함께 기능 구현해본다. 
@@ -7,38 +8,67 @@
 - 리팩토링이 가능하다는것을 느껴본다. 
 ```
 
-##  1. 시작전, 궁금증들 
+### 시작 후 목표
+- 요구사항을 AI 실행 프롬프트로 구조화하는 방법 알아보기
+```
+내 현재 학습 초점은 '설계는 내가, 구현은 AI가'라는 명확한 역할 분리다.
+TDD 방식으로 AI에게 코딩을 위임하면서도 설계 결정권은 내가 가져가는 방식이다. 
+여기서 질문이 생겼는데, 기능 요구사항을 받았을 때, 어떤 변환 과정을 거쳐 AI가 정확히 구현할 수 있는 프롬프트 형태로 만들어지는가?'
+
+이 변환 과정을 알아보는 것을 목표로 했다.
+```
 
-### 1. 목표를 세우며
-- 이 과정에서 나는 테스트 가능한 구조가 무엇인지 체감할 수 있을까?
-    - 어느 과정에서 테스트 가능한 구조라고 느꼈을까?
+### 내가 한 시도
 
-### 2. 멀티모듈 
-- 멀티모듈? 이게 뭐지? 왜 이 구조로 나눴어야 했지?
-- 각 모듈의 네이밍에는 -api , -batch, - streamer 라고 붙여져 있는데 왜 이렇게 붙인거지?
+시도 1: AI가 설계하고, AI가 결정
+- 방식: 기능 요구사항을 그대로 던져주고 TDD(Red-Green-Refactor)로 개발하라고 했다.
+- 문제점: 이 과정에서 내 설계도, 내 의도도 없다는 걸 자각했다. AI가 알아서 다 했을 뿐이었다.
 
+시도 2: AI가 설계하고, 내가 결정
+- 방식: AI가 설계 보고서를 작성하면 내가 읽고 결정하는 위치에 서기로 했다.
+- 문제점:
+  - AI가 너무 복잡한 설계를 제시했다.
+  - 그 문서를 읽는 데 시간이 많이 들었고, 전부 읽을 수도 없었다.
+  - 내 의도가 담긴 설계라고 전혀 느껴지지 않았다.
 
-### 3. 모듈 아키텍처(commerce-api)
-- 왜 Controller 패키지명이 아닌, interfaces라고 하지? 지금은 컨트롤러 하나 뿐인데? 확장성을 위해 먼저 이렇게 네이밍 짓는게 유리한가?
-- 계층간 DTO의 네이밍은 어떻게 지어야할까?
-- DTO를 내부클래스로 관리하고 있네? 파일 수를 줄이기 위함인가? 왜 이렇게 한거지? 이게 현업 방식인가?
-- 왜 온보딩 프로젝트에 JPA를 사용한거지? 쉽고 다들 사용하니까?
+시도 3: 내가 설계하고, AI의 피드백을 받기
+- 방식: 기능 요구사항으로부터 객체와 메시지 정의, 검증 및 예외 케이스를 내가 직접 문서로 정리했다.
+- 좋았던 점:
+  - 오직 내 설계 틀 안에서 AI가 고려해줘서, 유용한 피드백을 받았다.
+  - 레이어별 특징, 해야 할 것, 하지 말아야 할 것을 먼저 정의해야 한다는 걸 배웠다.
+  - 내가 놓친 엣지 케이스나 잠재적 문제를 해상도 높게 알려주고, 판단을 요구해줬다.
+- 문제점:
+  - 회원가입 기능을 도메인부터 API까지 전부 수도코드로 문서화하고 있었는데, 이러다 보니 생각이 들었다.
+  - "수도코드로 문서화할 바에, 그냥 내가 코드로 먼저 작성하고 이 스타일대로 나머지 기능을 구현하라고 하는 게 더 내 의도가 담긴 코드 아닌가?"
+  - 요구사항 규칙뿐만 아니라 개발 규칙들을 명확히 하는 것이 부족했다. 
+  - 내 의도를 설명하면서 개발 스타일을 알려줄 때, 지금처럼 문서로 전달하는 게 맞는지, 아니면 내가 기능 구현 하나를 예시로 만들어주고 이 스타일을 참고해서 개발하라고 해야 할지 고민이 들었다.
 
+시도 4: 내가 설계하고 시범 구현을 작성하고, AI에게 이 방식대로 하라고 명령
+- 방식: 회원가입 기능을 TDD(Red-Green-Refactor)로 도메인에서 API까지 직접 구현하고, 내 코드 스타일대로 다른 기능 개발을 맡겼다.
+- 진행 과정:
+  - AI는 A부터 Z까지 전부 만들어냈다.
+  - 나는 왜 그렇게 설계했고 만들었는지 물어보는 식으로 AI의 설계 사고를 배우고 있었다.
+  - 이 내용들은 내가 설계를 진행했어도 AI에게 물어볼 내용들이었다.
+  - 내 의도가 담긴 코드라기보다는, 나는 그 의도를 이해해 나가고, 동의하지 않으면 내 설계를 담아내는 식으로 진행했다.
+- 문제점:
+  - 한 번 구현하라고 할 때마다 오래 걸렸다. 처음부터 API까지 관련 모든 코드를 20분 동안 작업하고 있었다.
+  - 전부 한 큐에 완성시키기 때문에 양이 방대했다.
+  - 나는 추가된 main 코드 확인과 테스트 통과 여부만 확인하고 있었다.
+  - 이게 맞는 방식인지는 아직 잘 모르겠다.
 
-## 2. Round1 문서를 읽으며,  알게된 부분
 
-### 1. 테스트 코드 및 더블 
-- 나는 테스트 레이어별 어떤 기술들을 사용해야하는지 잘 모른다.
-- 테스트 작성 시, 레이어별 테스트 기술들에 익숙해지도록한다.
-- Mock(대역 객체)를 의미한다. 이 기술을 잘 모른다.
 
+### 과제 후 느낀점
+- AI 협업에 대한 미해결 고민
+  - 아직 어떻게 AI를 파트너로 협업하는 것인지 깨닫지 못했다.
+  - 이번 과제는 사실 처음부터 완벽한 설계를 만들고 AI에게 개발하라고 하는 게 아니라, 기능 요구사항으로부터 개발자가 직접 TDD를 구현하면서 이 과정에서 궁금하거나, 막히거나, 노가다 과정을 AI에게 맡기는 것을 기대한 과제였던 걸까?
+- 클로드 코드 사용 경험
+  - 이번에 클로드 코드를 사용해서 개발해보는 건 처음인데, 한 번의 명령으로 A부터 Z까지 기능 구현, 문서화, 테스트 코드 전부 구현해줘서 놀라웠다.
+  - 더 이상 구현은 중요하지 않다는 것을 이번에 체감했다.
+  - 대신 개발이 되는 환경을 잘 이해하는 것, 계층 책임이나 객체 책임 및 검증 스코프를 잘 정의하는 것, 이런 것들이 더 중요한 것 같은 느낌을 받았다.
+  - 클로드 스킬에 관심이 생겼다.
 
-### 2. 테스트 더블
-- Mock(대역 객체)를 의미한다. 이 기술을 잘 모른다.
-- 테스트 더블 사용 원칙 및 익숙해지도록 집중한다.
 
-### 3. TDD 가능한 구조의 특징
-- 가장 걱정되는건 비즈니스 로직 분리에서 어떤 기준으로 도메인 엔티티쪽에 로직을 둘지, 서비스에 둘지 판단하는 기준
 
 ---