diff --git a/.DS_Store b/.DS_Store
index 00c8cc12..eeea4158 100644
Binary files a/.DS_Store and b/.DS_Store differ
diff --git a/discodeit/.gitignore b/discodeit/.gitignore
index 4f59eb2d..e8ba384e 100644
--- a/discodeit/.gitignore
+++ b/discodeit/.gitignore
@@ -7,6 +7,7 @@ build/
 *.iml
 *.ipr
 *.iws
+/.claude
 
 # IDE - Eclipse
 .classpath
@@ -43,3 +44,8 @@ application-local.properties
 
 # File-based repository data
 file-data-map/
+
+# Newman test reports
+newman/
+newman-report*.html
+newman-report*.json
diff --git a/discodeit/TROUBLESHOOTING.md b/discodeit/TROUBLESHOOTING.md
new file mode 100644
index 00000000..6c050c32
--- /dev/null
+++ b/discodeit/TROUBLESHOOTING.md
@@ -0,0 +1,379 @@
+# 🔧 문제 해결 가이드
+
+디스코드잇 API 테스트 중 발생할 수 있는 문제와 해결 방법을 정리했습니다.
+
+---
+
+## 🔴 로그인 실패 (404 Not Found)
+
+### 증상
+```
+Login successful | AssertionError: expected response to have status code 200 but got 404
+```
+
+또는 응답:
+```json
+{
+  "message": "Invalid username or password",
+  "timestamp": "2026-02-09T..."
+}
+```
+
+### 원인
+**DB에 사용자가 존재하지 않습니다!**
+
+디스코드잇은 **JCF (Java Collection Framework) 메모리 기반 Repository**를 사용합니다:
+- ⚠️ 애플리케이션 재시작 시 **모든 데이터 삭제**
+- ⚠️ 메모리에만 저장되므로 영구 저장되지 않음
+
+### 해결 방법
+
+#### ✅ 올바른 순서:
+
+```
+1. 애플리케이션 실행
+   ↓
+2. 사용자 등록  ← 먼저 이것!
+   ↓
+3. 로그인  ← 그 다음 이것!
+```
+
+#### Postman에서:
+
+**1단계: 사용자 등록**
+```
+Collection > 1. 사용자 관리 > 사용자 등록
+```
+```json
+{
+  "username": "testuser",
+  "email": "test@example.com",
+  "password": "password123"
+}
+```
+**Send** → 201 Created 확인 ✅
+
+**2단계: 로그인**
+```
+Collection > 2. 권한 관리 > 로그인
+```
+```json
+{
+  "username": "testuser",
+  "password": "password123"
+}
+```
+**Send** → 200 OK 확인 ✅
+
+---
+
+## 🔴 채널/메시지 조회 실패 (404 Not Found)
+
+### 증상
+```json
+{
+  "message": "Channel not found: {uuid}",
+  "timestamp": "..."
+}
+```
+
+### 원인
+- Environment 변수 (`channelId`, `messageId` 등)가 비어있거나 잘못됨
+- 애플리케이션 재시작으로 데이터 손실
+
+### 해결 방법
+
+**1. Environment 변수 확인**
+- 우측 상단 Environment 아이콘 클릭
+- "Discodeit Local" 선택
+- `userId`, `channelId`, `messageId` 값 확인
+
+**2. 처음부터 다시 실행**
+```
+사용자 등록 → 채널 생성 → 메시지 전송
+```
+
+---
+
+## 🔴 Required request body is missing
+
+### 증상
+```json
+{
+  "message": "서버 내부 오류가 발생했습니다: Required request body is missing: ...",
+  "timestamp": "..."
+}
+```
+
+### 원인
+Body가 제대로 설정되지 않음
+
+### 해결 방법
+
+**Postman에서 확인:**
+
+1. **Body 탭 클릭**
+2. **raw** 선택 ✅
+3. 우측 드롭다운에서 **JSON** 선택 ✅ (Text가 아님!)
+4. JSON 데이터 입력
+
+```json
+{
+  "username": "testuser",
+  ...
+}
+```
+
+---
+
+## 🔴 애플리케이션이 실행되지 않음
+
+### 증상
+```
+Failed to connect to localhost port 8080
+```
+
+### 원인
+Spring Boot 애플리케이션이 실행되지 않음
+
+### 해결 방법
+
+**터미널에서:**
+```bash
+cd /Users/ijongho/IdeaProjects/9-sprint-mission/discodeit
+./gradlew bootRun
+```
+
+**또는 IDE에서:**
+- Spring Boot Application 실행 버튼 클릭
+
+**실행 확인:**
+```bash
+lsof -i :8080
+```
+
+정상 출력:
+```
+java    12345 user   50u  IPv6 ...  TCP *:http-alt (LISTEN)
+```
+
+---
+
+## 🔴 Environment 변수가 자동 저장되지 않음
+
+### 증상
+userId, channelId 등이 Environment에 저장되지 않음
+
+### 원인
+Tests 스크립트가 실행되지 않거나 오류 발생
+
+### 해결 방법
+
+**1. Console 확인**
+- Postman 하단의 **Console** 탭 확인
+- 에러 메시지나 로그 확인
+
+**2. Tests 탭 확인**
+- 요청의 **Tests** 탭에 스크립트가 있는지 확인
+- 예시:
+```javascript
+if (pm.response.code === 201) {
+    var jsonData = pm.response.json();
+    pm.environment.set("userId", jsonData.id);
+}
+```
+
+**3. 수동 저장**
+- 응답에서 `id` 복사
+- Environment 편집 → `userId`에 붙여넣기
+
+---
+
+## 🔴 JSON parse error
+
+### 증상
+```json
+{
+  "message": "서버 내부 오류가 발생했습니다: JSON parse error: ...",
+  "timestamp": "..."
+}
+```
+
+### 원인
+JSON 형식이 잘못됨
+
+### 해결 방법
+
+**올바른 JSON 형식:**
+```json
+{
+  "username": "testuser",
+  "email": "test@example.com"
+}
+```
+
+**잘못된 예:**
+```json
+{
+  username: "testuser",  // ❌ 키에 따옴표 없음
+  "email": 'test@example.com'  // ❌ 작은따옴표
+}
+```
+
+**팁:**
+- JSON Validator 사용: https://jsonlint.com/
+- Postman이 자동으로 검증해줌 (빨간 밑줄)
+
+---
+
+## 🔴 Private channel cannot be updated
+
+### 증상
+```json
+{
+  "message": "Private channel cannot be updated",
+  "timestamp": "..."
+}
+```
+
+### 원인
+비공개 채널은 수정할 수 없도록 설계됨
+
+### 해결 방법
+
+**비공개 채널은 수정 불가**
+- 공개 채널만 수정 가능
+- 비공개 채널을 수정하려면 삭제 후 재생성
+
+---
+
+## 🔴 이메일/사용자명 중복
+
+### 증상
+```json
+{
+  "message": "이 사용자 이름은 이미 존재해요!: testuser",
+  "timestamp": "..."
+}
+```
+
+또는
+```json
+{
+  "message": "이 이메일은 이미 존재해요!: test@example.com",
+  "timestamp": "..."
+}
+```
+
+### 원인
+같은 사용자명 또는 이메일로 중복 등록 시도
+
+### 해결 방법
+
+**다른 사용자명/이메일 사용:**
+```json
+{
+  "username": "testuser2",  // ← 변경
+  "email": "test2@example.com",  // ← 변경
+  "password": "password123"
+}
+```
+
+---
+
+## 📊 데이터 초기화
+
+### 애플리케이션 재시작 시
+
+**JCF Repository 특성:**
+- ✅ 빠른 개발/테스트
+- ❌ 영구 저장 안됨
+- ❌ 재시작 시 모든 데이터 삭제
+
+**재시작 후 해야 할 일:**
+```
+1. 사용자 등록
+2. 채널 생성
+3. 메시지 전송
+```
+
+---
+
+## 💡 유용한 팁
+
+### 1. Collection Runner 사용
+
+전체 API를 순서대로 자동 실행:
+1. Collection 우클릭 → **Run collection**
+2. 순서 설정
+3. **Run** 클릭
+
+### 2. Pre-request Script
+
+자동으로 현재 시간 설정:
+```javascript
+pm.environment.set("currentTime", new Date().toISOString());
+```
+
+### 3. Console 활용
+
+- **View → Show Postman Console** (Cmd/Ctrl + Alt + C)
+- 모든 요청/응답 로그 확인
+- 디버깅에 매우 유용
+
+### 4. Environment 백업
+
+- Environment Export → JSON 파일 저장
+- 필요시 다시 Import
+
+---
+
+## 📞 추가 도움
+
+### 로그 확인
+
+**Spring Boot 로그:**
+- 애플리케이션 실행 터미널/콘솔
+- 에러 스택 트레이스 확인
+
+**Postman Console:**
+- Postman 하단 Console 탭
+- 요청/응답 상세 정보
+
+### 도구
+
+**Bash 스크립트:**
+```bash
+/tmp/test_discodeit_api.sh
+```
+
+**Python 스크립트:**
+```bash
+pip install -r requirements.txt
+python test_api_automation.py
+```
+
+**API 문서:**
+```
+API_DOCUMENTATION.md
+POSTMAN_GUIDE.md
+```
+
+---
+
+## ✅ 체크리스트
+
+문제 발생 시 확인:
+
+- [ ] 애플리케이션이 실행 중인가? (`lsof -i :8080`)
+- [ ] 올바른 Environment가 선택되었는가? ("Discodeit Local")
+- [ ] 사용자를 먼저 등록했는가?
+- [ ] Body 탭에서 raw + JSON이 선택되었는가?
+- [ ] JSON 형식이 올바른가?
+- [ ] Environment 변수가 설정되었는가?
+- [ ] URL이 올바른가? (`/auth/login` 등)
+- [ ] Method가 올바른가? (POST, GET 등)
+
+---
+
+**Happy Testing! 🎉**
diff --git a/discodeit/collection_structure.txt b/discodeit/collection_structure.txt
new file mode 100644
index 00000000..3260feea
--- /dev/null
+++ b/discodeit/collection_structure.txt
@@ -0,0 +1,27 @@
+디스코드잇 API v2 구조 (수정됨)
+
+0. 초기 설정 (먼저 실행)
+├── 사용자 1 등록 (user1)
+├── 사용자 2 등록 (user2)
+├── 사용자 3 등록 (user3)
+├── 채널 1 생성 (일반)
+├── 채널 2 생성 (공지)
+└── 채널 3 생성 (질문)
+
+1. 사용자 관리
+├── 전체 사용자 조회 ✅ Tests 추가
+├── 사용자1 조회 ✅ Tests 추가
+├── 사용자1 온라인 상태 업데이트 ✅ Tests 추가
+├── 추가 사용자 등록 (user4) ✅ 수정 테스트용
+├── user4 정보 수정 ✅ user2 대신 user4 수정
+└── 사용자3 삭제 (테스트용) ✅ Tests 추가
+
+2. 권한 관리
+├── user1 로그인 ✅ Tests 개선
+└── user2 로그인 ✅ Tests 개선
+
+핵심 수정:
+- user2는 삭제/수정하지 않음 (로그인 테스트용)
+- user4를 추가로 생성해서 수정 테스트
+- 모든 API에 Tests 스크립트 추가
+- 순서 재조정
diff --git a/discodeit/docs/API-TEST-GUIDE.md b/discodeit/docs/API-TEST-GUIDE.md
new file mode 100644
index 00000000..278b6911
--- /dev/null
+++ b/discodeit/docs/API-TEST-GUIDE.md
@@ -0,0 +1,167 @@
+# 📮 API 테스트 가이드
+
+IntelliJ IDEA의 HTTP Client를 사용하여 모든 API를 자동으로 테스트할 수 있습니다.
+
+## 🚀 빠른 시작
+
+### 1. 파일 열기
+
+IntelliJ에서 다음 파일 중 하나를 엽니다:
+
+- **`api-tests-with-env.http`** (권장) - 환경 변수 사용
+- **`api-tests.http`** - 기본 버전
+
+### 2. 환경 선택
+
+`api-tests-with-env.http` 사용 시:
+- 파일 우측 상단의 환경 드롭다운에서 **`dev`** 선택
+- 실제 사용자 ID가 자동으로 적용됩니다
+
+### 3. API 실행
+
+각 요청 옆의 **▶ 버튼** 클릭 또는:
+- **Windows/Linux**: `Ctrl` + `Enter`
+- **Mac**: `Cmd` + `Enter`
+
+### 4. 결과 확인
+
+- 하단에 응답 결과가 표시됩니다
+- JSON 형식으로 자동 포맷팅됩니다
+- 에러 발생 시 상태 코드와 메시지 확인 가능
+
+## 📋 테스트 항목
+
+### ✅ 사용자 관리
+- [x] 모든 사용자 조회
+- [x] 특정 사용자 조회
+- [x] 사용자 생성 (JSON)
+- [x] 사용자 생성 (프로필 이미지 포함)
+- [x] 사용자 정보 수정 (JSON)
+- [x] 사용자 정보 수정 (프로필 이미지 포함)
+- [x] 사용자 삭제
+
+### ✅ 사용자 상태 관리
+- [x] 온라인 상태 업데이트
+- [x] 여러 사용자 상태 일괄 업데이트
+
+### ✅ 바이너리 콘텐츠
+- [x] 파일 1개 조회
+- [x] 파일 여러개 조회
+
+### ✅ 시나리오 테스트
+- [x] 사용자 생성 → 조회 → 수정 → 삭제 전체 플로우
+- [x] 자동 검증 (응답 상태 코드, 데이터 검증)
+
+### ✅ 에러 케이스
+- [x] 중복 이메일 검증
+- [x] 존재하지 않는 리소스 조회 (404)
+
+## 🔧 환경 변수
+
+`http-client.env.json` 파일에 정의된 변수들:
+
+```json
+{
+  "dev": {
+    "baseUrl": "http://localhost:8080",
+    "user1Id": "한성재 사용자 ID",
+    "user1ProfileId": "한성재 프로필 이미지 ID",
+    "user2Id": "서현하 사용자 ID",
+    ...
+  }
+}
+```
+
+### 사용 예시
+```http
+GET {{baseUrl}}/users/{{user1Id}}
+```
+
+## 💡 동적 변수
+
+IntelliJ HTTP Client가 제공하는 동적 변수:
+
+| 변수 | 설명 | 예시 |
+|------|------|------|
+| `{{$uuid}}` | 랜덤 UUID | `123e4567-e89b-12d3-a456-426614174000` |
+| `{{$timestamp}}` | Unix 타임스탬프 | `1707567890123` |
+| `{{$isoTimestamp}}` | ISO 8601 시간 | `2026-02-10T08:23:57Z` |
+| `{{$randomInt}}` | 랜덤 정수 (0-1000) | `742` |
+
+### 사용 예시
+```http
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "user_{{$randomInt}}",
+  "email": "user_{{$timestamp}}@test.com",
+  "password": "password123"
+}
+```
+
+## 🧪 자동 검증
+
+응답 검증 스크립트 예시:
+
+```javascript
+> {%
+    client.test("사용자 조회 성공", function() {
+        client.assert(response.status === 200, "상태 코드가 200이어야 함");
+        client.assert(response.body.username !== null, "사용자명이 있어야 함");
+    });
+    client.log("✅ 테스트 통과");
+%}
+```
+
+## 🎯 시나리오 테스트 실행
+
+전체 시나리오를 순서대로 실행:
+
+1. **사용자 생성** → `newUserId` 변수에 저장
+2. **생성한 사용자 조회** → `newUserId` 사용
+3. **온라인 상태 업데이트** → `newUserId` 사용
+4. **사용자 정보 수정** → `newUserId` 사용
+5. **사용자 삭제** → `newUserId` 사용
+6. **삭제 확인 (404)** → `newUserId` 사용
+
+각 단계마다 자동으로 검증이 실행됩니다.
+
+## 📊 실행 결과 예시
+
+```
+✅ 사용자 생성 완료 - ID: 123e4567-e89b-12d3-a456-426614174000
+✅ 사용자 조회 완료 - 이름: 시나리오유저
+✅ 온라인 상태 업데이트 완료
+✅ 사용자 정보 수정 완료
+✅ 사용자 삭제 완료
+✅ 삭제 확인 완료 - 404 응답
+```
+
+## 🔄 데이터 초기화
+
+테스트 후 데이터 초기화가 필요하면:
+
+1. 애플리케이션 재시작
+2. 초기 4명의 사용자만 남음 (한성재, 장현민, 전명훈, 서현하)
+
+## 🆘 문제 해결
+
+### Q: "환경을 선택할 수 없어요"
+**A**: `http-client.env.json` 파일이 프로젝트 루트에 있는지 확인하세요.
+
+### Q: "프로필 이미지 업로드가 실패해요"
+**A**: `src/main/resources/data/profiles/` 폴더에 이미지 파일이 있는지 확인하세요.
+
+### Q: "중복 이메일 오류가 나요"
+**A**: 동적 변수 `{{$randomInt}}`나 `{{$timestamp}}`를 사용해서 고유한 이메일을 생성하세요.
+
+### Q: "404 오류가 나요"
+**A**:
+- 애플리케이션이 실행 중인지 확인 (`http://localhost:8080`)
+- `http-client.env.json`의 ID 값이 최신인지 확인
+
+## 📚 추가 리소스
+
+- [IntelliJ HTTP Client 공식 문서](https://www.jetbrains.com/help/idea/http-client-in-product-code-editor.html)
+- [환경 변수 설정 가이드](https://www.jetbrains.com/help/idea/exploring-http-syntax.html#environment-variables)
diff --git a/discodeit/docs/Discodeit API.postman_collection.json b/discodeit/docs/Discodeit API.postman_collection.json
new file mode 100644
index 00000000..253ad707
--- /dev/null
+++ b/discodeit/docs/Discodeit API.postman_collection.json	
@@ -0,0 +1,1291 @@
+{
+  "info": {
+    "name": "Discodeit API",
+    "description": "Discodeit API 자동 테스트 컬렉션\n\n웹 API 요구사항 순서대로 테스트가 구성되어 있습니다.",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+    "_exporter_id": "discodeit-api"
+  },
+  "item": [
+    {
+      "name": "사용자 관리",
+      "item": [
+        {
+          "name": "사용자 등록",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200 또는 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    if (!user.id) {",
+                  "        throw new Error('생성된 사용자에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    if (!user.email) {",
+                  "        throw new Error('생성된 사용자에 이메일이 없음');",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 사용자 ID 저장",
+                  "    pm.environment.set('createdUserId', user.id);",
+                  "    ",
+                  "    pm.test('사용자 등록 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 등록 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            },
+            {
+              "listen": "prerequest",
+              "script": {
+                "exec": [
+                  "// 매번 다른 이메일 생성",
+                  "pm.environment.set('randomEmail', 'newuser' + Date.now() + '@example.com');"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"새로운사용자\",\n  \"email\": \"{{randomEmail}}\",\n  \"password\": \"password123\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users",
+              "host": ["{{baseUrl}}"],
+              "path": ["users"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 정보 수정",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    const expectedId = pm.environment.get('user2Id');",
+                  "    if (user.id !== expectedId) {",
+                  "        throw new Error(`사용자 ID 변경됨: ${user.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('사용자 정보 수정 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 정보 수정 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"{{user2Name}}_수정됨\",\n  \"email\": \"{{user2Email}}\",\n  \"password\": \"newpassword123\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user2Id}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user2Id}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 삭제",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 204) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200 또는 204)`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('사용자 삭제 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 삭제 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "DELETE",
+            "header": [],
+            "url": {
+              "raw": "{{baseUrl}}/users/{{createdUserId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{createdUserId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "모든 사용자 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const users = pm.response.json();",
+                  "    if (!Array.isArray(users)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (users.length === 0) {",
+                  "        throw new Error('사용자 목록이 비어있음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'username', 'email', 'online'];",
+                  "    const missingFields = requiredFields.filter(field => !users[0].hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('모든 사용자 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`모든 사용자 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/users",
+              "host": ["{{baseUrl}}"],
+              "path": ["users"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 온라인 상태 업데이트 (이영희)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user2Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user2Id}}", "status"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 온라인 상태 업데이트 (박민수)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user3Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user3Id}}", "status"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 온라인 상태 업데이트 (최지연)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user4Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user4Id}}", "status"]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "권한 관리",
+      "item": [
+        {
+          "name": "사용자 로그인 (박민수)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    if (typeof user !== 'object' || Array.isArray(user)) {",
+                  "        throw new Error('응답이 객체가 아님');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'username', 'email'];",
+                  "    const missingFields = requiredFields.filter(field => !user.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    // 박민수로 로그인했는지 확인",
+                  "    const expectedId = pm.environment.get('user3Id');",
+                  "    if (user.id !== expectedId) {",
+                  "        throw new Error(`사용자 ID 불일치: ${user.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('사용자 로그인 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 로그인 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"{{user3Name}}\",\n  \"password\": \"password123\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/auth/login",
+              "host": ["{{baseUrl}}"],
+              "path": ["auth", "login"]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "채널 관리",
+      "item": [
+        {
+          "name": "공개 채널 생성",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const channel = pm.response.json();",
+                  "    if (!channel.id) {",
+                  "        throw new Error('생성된 채널에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'name'];",
+                  "    const missingFields = requiredFields.filter(field => !channel.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    // isPrivate 필드가 있는 경우에만 검증",
+                  "    if (channel.hasOwnProperty('isPrivate') && channel.isPrivate !== false) {",
+                  "        throw new Error('공개 채널이 아님');",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 채널 ID 저장",
+                  "    pm.environment.set('createdPublicChannelId', channel.id);",
+                  "    ",
+                  "    pm.test('공개 채널 생성 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`공개 채널 생성 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"name\": \"테스트 공개 채널\",\n  \"description\": \"Postman 테스트용 공개 채널\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/channels/public",
+              "host": ["{{baseUrl}}"],
+              "path": ["channels", "public"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "비공개 채널 생성",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const channel = pm.response.json();",
+                  "    if (!channel.id) {",
+                  "        throw new Error('생성된 채널에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'name'];",
+                  "    const missingFields = requiredFields.filter(field => !channel.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    // isPrivate 필드가 있는 경우에만 검증",
+                  "    if (channel.hasOwnProperty('isPrivate') && channel.isPrivate !== true) {",
+                  "        throw new Error('비공개 채널이 아님');",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 채널 ID 저장",
+                  "    pm.environment.set('createdPrivateChannelId', channel.id);",
+                  "    ",
+                  "    pm.test('비공개 채널 생성 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`비공개 채널 생성 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"name\": \"테스트 비공개 채널\",\n  \"description\": \"Postman 테스트용 비공개 채널\",\n  \"memberIds\": [\"{{user2Id}}\", \"{{user3Id}}\"]\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/channels/private",
+              "host": ["{{baseUrl}}"],
+              "path": ["channels", "private"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "공개 채널 정보 수정",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const channel = pm.response.json();",
+                  "    const expectedId = pm.environment.get('createdPublicChannelId');",
+                  "    if (channel.id !== expectedId) {",
+                  "        throw new Error(`채널 ID 불일치: ${channel.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('공개 채널 정보 수정 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`공개 채널 정보 수정 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"name\": \"수정된 공개 채널\",\n  \"description\": \"채널 정보가 수정되었습니다\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/channels/{{createdPublicChannelId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["channels", "{{createdPublicChannelId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "채널 삭제",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 204) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 204)`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('채널 삭제 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`채널 삭제 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "DELETE",
+            "header": [],
+            "url": {
+              "raw": "{{baseUrl}}/channels/{{createdPrivateChannelId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["channels", "{{createdPrivateChannelId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "특정 사용자의 모든 채널 목록 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const channels = pm.response.json();",
+                  "    if (!Array.isArray(channels)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (channels.length === 0) {",
+                  "        throw new Error('채널 목록이 비어있음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'name'];",
+                  "    const missingFields = requiredFields.filter(field => !channels[0].hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('채널 목록 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`채널 목록 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/channels?userId={{user2Id}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["channels"],
+              "query": [
+                {
+                  "key": "userId",
+                  "value": "{{user2Id}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "메시지 관리",
+      "item": [
+        {
+          "name": "메시지 보내기",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const message = pm.response.json();",
+                  "    if (!message.id) {",
+                  "        throw new Error('생성된 메시지에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'content', 'channelId', 'authorId'];",
+                  "    const missingFields = requiredFields.filter(field => !message.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 메시지 ID 저장",
+                  "    pm.environment.set('createdMessageId', message.id);",
+                  "    ",
+                  "    pm.test('메시지 보내기 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 보내기 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"content\": \"Postman 테스트 메시지\",\n  \"channelId\": \"{{createdPublicChannelId}}\",\n  \"authorId\": \"{{user2Id}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/messages",
+              "host": ["{{baseUrl}}"],
+              "path": ["messages"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "메시지 수정",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const message = pm.response.json();",
+                  "    const expectedId = pm.environment.get('createdMessageId');",
+                  "    if (message.id !== expectedId) {",
+                  "        throw new Error(`메시지 ID 불일치: ${message.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('메시지 수정 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 수정 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"content\": \"수정된 메시지 내용\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/messages/{{createdMessageId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["messages", "{{createdMessageId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "메시지 삭제",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 204) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 204)`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('메시지 삭제 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 삭제 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "DELETE",
+            "header": [],
+            "url": {
+              "raw": "{{baseUrl}}/messages/{{createdMessageId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["messages", "{{createdMessageId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "특정 채널의 메시지 목록 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const messages = pm.response.json();",
+                  "    if (!Array.isArray(messages)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    // 메시지가 삭제되어 비어있을 수 있으므로 경고만 출력",
+                  "    if (messages.length === 0) {",
+                  "        console.log('경고: 메시지 목록이 비어있음 (이전 테스트에서 삭제됨)');",
+                  "    } else {",
+                  "        // 메시지가 있으면 필드 검증",
+                  "        const requiredFields = ['id', 'content', 'channelId', 'authorId'];",
+                  "        const missingFields = requiredFields.filter(field => !messages[0].hasOwnProperty(field));",
+                  "        if (missingFields.length > 0) {",
+                  "            throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "        }",
+                  "    }",
+                  "    ",
+                  "    pm.test('메시지 목록 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 목록 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/messages?channelId={{createdPublicChannelId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["messages"],
+              "query": [
+                {
+                  "key": "channelId",
+                  "value": "{{createdPublicChannelId}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "메시지 수신 정보 관리",
+      "item": [
+        {
+          "name": "특정 채널의 메시지 수신 정보 생성",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const readStatus = pm.response.json();",
+                  "    if (!readStatus.id) {",
+                  "        throw new Error('생성된 수신 정보에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'userId', 'channelId'];",
+                  "    const missingFields = requiredFields.filter(field => !readStatus.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 수신 정보 ID 저장",
+                  "    pm.environment.set('createdReadStatusId', readStatus.id);",
+                  "    ",
+                  "    pm.test('메시지 수신 정보 생성 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 수신 정보 생성 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"userId\": \"{{user2Id}}\",\n  \"channelId\": \"{{createdPublicChannelId}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/read-statuses",
+              "host": ["{{baseUrl}}"],
+              "path": ["read-statuses"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "특정 채널의 메시지 수신 정보 수정",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const readStatus = pm.response.json();",
+                  "    const expectedId = pm.environment.get('createdReadStatusId');",
+                  "    if (readStatus.id !== expectedId) {",
+                  "        throw new Error(`수신 정보 ID 불일치: ${readStatus.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('메시지 수신 정보 수정 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 수신 정보 수정 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastReadMessageId\": \"{{createdMessageId}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/read-statuses/{{createdReadStatusId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["read-statuses", "{{createdReadStatusId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "특정 사용자의 메시지 수신 정보 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const readStatuses = pm.response.json();",
+                  "    if (!Array.isArray(readStatuses)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (readStatuses.length === 0) {",
+                  "        throw new Error('수신 정보 목록이 비어있음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'userId', 'channelId'];",
+                  "    const missingFields = requiredFields.filter(field => !readStatuses[0].hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('메시지 수신 정보 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`메시지 수신 정보 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/read-statuses?userId={{user2Id}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["read-statuses"],
+              "query": [
+                {
+                  "key": "userId",
+                  "value": "{{user2Id}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "바이너리 파일 다운로드",
+      "item": [
+        {
+          "name": "바이너리 파일 1개 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const content = pm.response.json();",
+                  "    const expectedId = pm.environment.get('user2ProfileId');",
+                  "    if (content.id !== expectedId) {",
+                  "        throw new Error(`파일 ID 불일치: ${content.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'filename', 'contentType'];",
+                  "    const missingFields = requiredFields.filter(field => !content.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 1개 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 1개 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents/{{user2ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents", "{{user2ProfileId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "바이너리 파일 여러 개 조회 (2명)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const contents = pm.response.json();",
+                  "    if (!Array.isArray(contents)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (contents.length === 0) {",
+                  "        throw new Error('조회된 파일이 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 여러 개 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 여러 개 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents?ids={{user2ProfileId}},{{user3ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents"],
+              "query": [
+                {
+                  "key": "ids",
+                  "value": "{{user2ProfileId}},{{user3ProfileId}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "바이너리 파일 여러 개 조회 (전체)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const contents = pm.response.json();",
+                  "    if (!Array.isArray(contents)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (contents.length === 0) {",
+                  "        throw new Error('조회된 파일이 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 여러 개 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 여러 개 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents?ids={{user2ProfileId}},{{user3ProfileId}},{{user4ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents"],
+              "query": [
+                {
+                  "key": "ids",
+                  "value": "{{user2ProfileId}},{{user3ProfileId}},{{user4ProfileId}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        }
+      ]
+    }
+  ]
+}
diff --git a/discodeit/docs/Discodeit API.postman_test_run.json b/discodeit/docs/Discodeit API.postman_test_run.json
new file mode 100644
index 00000000..beb22f0e
--- /dev/null
+++ b/discodeit/docs/Discodeit API.postman_test_run.json	
@@ -0,0 +1,735 @@
+{
+	"id": "72aa7dc4-e6f3-482f-9d9c-1131467aaa6d",
+	"name": "Discodeit API",
+	"timestamp": "2026-02-11T13:40:36.311Z",
+	"collection_id": "52123612-cc7620c4-e129-4558-909c-60cb60c4a7d8",
+	"folder_id": 0,
+	"environment_id": "52123612-b20157c7-1753-4dd5-a79e-ca28791a47c2",
+	"totalPass": 23,
+	"delay": 0,
+	"persist": true,
+	"status": "finished",
+	"startedAt": "2026-02-11T13:40:35.589Z",
+	"totalFail": 0,
+	"results": [
+		{
+			"id": "62f080e5-1d87-4729-b59c-d9c262cc57f6",
+			"name": "사용자 등록",
+			"url": "http://localhost:8080/users",
+			"time": 81,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"사용자 등록 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 등록 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				81
+			],
+			"allTests": [
+				{
+					"사용자 등록 성공": true
+				}
+			]
+		},
+		{
+			"id": "38f02c1b-1da3-4305-8a73-966ecd4f514a",
+			"name": "사용자 정보 수정",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001",
+			"time": 5,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"사용자 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"사용자 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "e223f7ff-58d7-474b-916f-bb9e870340a0",
+			"name": "사용자 삭제",
+			"url": "http://localhost:8080/users/199f91c7-2ba9-41d0-9cd9-6bb94a002f3b",
+			"time": 3,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"사용자 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"사용자 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "05657515-669f-416b-abb6-bcd7a6ffc9b1",
+			"name": "모든 사용자 조회",
+			"url": "http://localhost:8080/users",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"모든 사용자 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"모든 사용자 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"모든 사용자 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "3c0426e3-cad0-45a9-b870-d3542de16393",
+			"name": "사용자 온라인 상태 업데이트 (이영희)",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001/status",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "1fccb8ae-a199-42c2-84b1-2e6e050ac4d5",
+			"name": "사용자 온라인 상태 업데이트 (박민수)",
+			"url": "http://localhost:8080/users/30000000-0000-0000-0000-000000000001/status",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "e4500e3f-52b4-40ab-873a-7f0c488a79ba",
+			"name": "사용자 온라인 상태 업데이트 (최지연)",
+			"url": "http://localhost:8080/users/40000000-0000-0000-0000-000000000001/status",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "13e2e344-786e-4ec1-bc5f-a73047a93695",
+			"name": "사용자 로그인 (박민수)",
+			"url": "http://localhost:8080/auth/login",
+			"time": 4,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"사용자 로그인 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 로그인 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"사용자 로그인 성공": true
+				}
+			]
+		},
+		{
+			"id": "67a951f5-93ee-4ea9-967c-e8e29fb4b6ad",
+			"name": "공개 채널 생성",
+			"url": "http://localhost:8080/channels/public",
+			"time": 7,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"공개 채널 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"공개 채널 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				7
+			],
+			"allTests": [
+				{
+					"공개 채널 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "f8543bc4-6878-4e40-84b0-48293ece9e98",
+			"name": "비공개 채널 생성",
+			"url": "http://localhost:8080/channels/private",
+			"time": 6,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"비공개 채널 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"비공개 채널 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"비공개 채널 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "c448ff0b-1c2c-44d6-ac60-a1755ac7b888",
+			"name": "공개 채널 정보 수정",
+			"url": "http://localhost:8080/channels/f16f2249-9b95-4ade-8c9a-dcab427daf29",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"공개 채널 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"공개 채널 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"공개 채널 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "e7cdf82b-b3be-457d-93c9-8b4610e1e4db",
+			"name": "채널 삭제",
+			"url": "http://localhost:8080/channels/3f35e0e6-5a0b-4095-aeaf-ac541b04c38b",
+			"time": 2,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"채널 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"채널 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"채널 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "bd3213a7-5150-4bbe-8b10-177e2b9b15c1",
+			"name": "특정 사용자의 모든 채널 목록 조회",
+			"url": "http://localhost:8080/channels?userId=20000000-0000-0000-0000-000000000001",
+			"time": 4,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"채널 목록 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"채널 목록 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"채널 목록 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "468a25e1-0e84-435d-96da-779eb8e77281",
+			"name": "메시지 보내기",
+			"url": "http://localhost:8080/messages",
+			"time": 5,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"메시지 보내기 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 보내기 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"메시지 보내기 성공": true
+				}
+			]
+		},
+		{
+			"id": "1122053e-946c-44d9-a1bc-5c814f355f0b",
+			"name": "메시지 수정",
+			"url": "http://localhost:8080/messages/bcf42db0-a178-4c67-85b8-b00e6216ea2a",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "1cb94982-c954-4c27-bb93-441313ce2519",
+			"name": "메시지 삭제",
+			"url": "http://localhost:8080/messages/bcf42db0-a178-4c67-85b8-b00e6216ea2a",
+			"time": 3,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"메시지 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "52706e31-cbee-4fdc-9638-44097655653d",
+			"name": "특정 채널의 메시지 목록 조회",
+			"url": "http://localhost:8080/messages?channelId=f16f2249-9b95-4ade-8c9a-dcab427daf29",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 목록 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 목록 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 목록 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "5b4ca621-295c-4261-a9df-9978c4f22062",
+			"name": "특정 채널의 메시지 수신 정보 생성",
+			"url": "http://localhost:8080/read-statuses",
+			"time": 4,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"메시지 수신 정보 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "7ab4d359-041b-4b6e-b686-bebb06a082bd",
+			"name": "특정 채널의 메시지 수신 정보 수정",
+			"url": "http://localhost:8080/read-statuses/4936dd2f-9cca-460c-8bfd-1e0a6b3c84ab",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수신 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "182a1d87-c2cc-4d03-9ff1-2cc073749b91",
+			"name": "특정 사용자의 메시지 수신 정보 조회",
+			"url": "http://localhost:8080/read-statuses?userId=20000000-0000-0000-0000-000000000001",
+			"time": 2,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수신 정보 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "2ea5804a-177f-4c81-861c-2074010d9e74",
+			"name": "바이너리 파일 1개 조회",
+			"url": "http://localhost:8080/binary-contents/20000000-0000-0000-0000-000000000002",
+			"time": 7,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 1개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 1개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				7
+			],
+			"allTests": [
+				{
+					"파일 1개 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "71b66c5b-c4c6-4fc0-9df8-15780abe0860",
+			"name": "바이너리 파일 여러 개 조회 (2명)",
+			"url": "http://localhost:8080/binary-contents?ids=20000000-0000-0000-0000-000000000002,30000000-0000-0000-0000-000000000002",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 여러 개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 여러 개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"파일 여러 개 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "365c8a34-d62f-413d-81e0-46e02a774df0",
+			"name": "바이너리 파일 여러 개 조회 (전체)",
+			"url": "http://localhost:8080/binary-contents?ids=20000000-0000-0000-0000-000000000002,30000000-0000-0000-0000-000000000002,40000000-0000-0000-0000-000000000002",
+			"time": 2,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 여러 개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 여러 개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"파일 여러 개 조회 성공": true
+				}
+			]
+		}
+	],
+	"count": 1,
+	"totalTime": 168,
+	"collection": {
+		"requests": [
+			{
+				"id": "62f080e5-1d87-4729-b59c-d9c262cc57f6",
+				"method": "POST"
+			},
+			{
+				"id": "38f02c1b-1da3-4305-8a73-966ecd4f514a",
+				"method": "PUT"
+			},
+			{
+				"id": "e223f7ff-58d7-474b-916f-bb9e870340a0",
+				"method": "DELETE"
+			},
+			{
+				"id": "05657515-669f-416b-abb6-bcd7a6ffc9b1",
+				"method": "GET"
+			},
+			{
+				"id": "3c0426e3-cad0-45a9-b870-d3542de16393",
+				"method": "PUT"
+			},
+			{
+				"id": "1fccb8ae-a199-42c2-84b1-2e6e050ac4d5",
+				"method": "PUT"
+			},
+			{
+				"id": "e4500e3f-52b4-40ab-873a-7f0c488a79ba",
+				"method": "PUT"
+			},
+			{
+				"id": "13e2e344-786e-4ec1-bc5f-a73047a93695",
+				"method": "POST"
+			},
+			{
+				"id": "67a951f5-93ee-4ea9-967c-e8e29fb4b6ad",
+				"method": "POST"
+			},
+			{
+				"id": "f8543bc4-6878-4e40-84b0-48293ece9e98",
+				"method": "POST"
+			},
+			{
+				"id": "c448ff0b-1c2c-44d6-ac60-a1755ac7b888",
+				"method": "PUT"
+			},
+			{
+				"id": "e7cdf82b-b3be-457d-93c9-8b4610e1e4db",
+				"method": "DELETE"
+			},
+			{
+				"id": "bd3213a7-5150-4bbe-8b10-177e2b9b15c1",
+				"method": "GET"
+			},
+			{
+				"id": "468a25e1-0e84-435d-96da-779eb8e77281",
+				"method": "POST"
+			},
+			{
+				"id": "1122053e-946c-44d9-a1bc-5c814f355f0b",
+				"method": "PUT"
+			},
+			{
+				"id": "1cb94982-c954-4c27-bb93-441313ce2519",
+				"method": "DELETE"
+			},
+			{
+				"id": "52706e31-cbee-4fdc-9638-44097655653d",
+				"method": "GET"
+			},
+			{
+				"id": "5b4ca621-295c-4261-a9df-9978c4f22062",
+				"method": "POST"
+			},
+			{
+				"id": "7ab4d359-041b-4b6e-b686-bebb06a082bd",
+				"method": "PUT"
+			},
+			{
+				"id": "182a1d87-c2cc-4d03-9ff1-2cc073749b91",
+				"method": "GET"
+			},
+			{
+				"id": "2ea5804a-177f-4c81-861c-2074010d9e74",
+				"method": "GET"
+			},
+			{
+				"id": "71b66c5b-c4c6-4fc0-9df8-15780abe0860",
+				"method": "GET"
+			},
+			{
+				"id": "365c8a34-d62f-413d-81e0-46e02a774df0",
+				"method": "GET"
+			}
+		]
+	}
+}
\ No newline at end of file
diff --git a/discodeit/docs/Discodeit.postman_environment.json b/discodeit/docs/Discodeit.postman_environment.json
new file mode 100644
index 00000000..9c5d1b84
--- /dev/null
+++ b/discodeit/docs/Discodeit.postman_environment.json
@@ -0,0 +1,111 @@
+{
+  "id": "discodeit-environment",
+  "name": "Discodeit Environment",
+  "values": [
+    {
+      "key": "baseUrl",
+      "value": "http://localhost:8080",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Id",
+      "value": "10000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Name",
+      "value": "김철수",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Email",
+      "value": "kimcs@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1ProfileId",
+      "value": "10000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Id",
+      "value": "20000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Name",
+      "value": "이영희",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Email",
+      "value": "leeyh@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2ProfileId",
+      "value": "20000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Id",
+      "value": "30000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Name",
+      "value": "박민수",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Email",
+      "value": "parkms@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3ProfileId",
+      "value": "30000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Id",
+      "value": "40000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Name",
+      "value": "최지연",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Email",
+      "value": "choijy@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4ProfileId",
+      "value": "40000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    }
+  ],
+  "_postman_variable_scope": "environment",
+  "_postman_exported_at": "2026-02-11T00:33:00.000Z",
+  "_postman_exported_using": "Postman/11.0.0"
+}
diff --git a/discodeit/docs/README4.md b/discodeit/docs/README4.md
new file mode 100644
index 00000000..d2a3d46f
--- /dev/null
+++ b/discodeit/docs/README4.md
@@ -0,0 +1,1545 @@
+# 📚 디스코드잇 프로젝트 완벽 가이드 (초보자용)
+
+> 웹 API 기반 Spring Boot 애플리케이션의 전체 구조와 동작 원리를 이해하기 위한 완벽 가이드
+
+---
+
+## 📖 목차
+
+1. [프로젝트 개요](#1-프로젝트-개요)
+2. [전체 아키텍처](#2-전체-아키텍처)
+3. [계층별 상세 설명](#3-계층별-상세-설명)
+4. [웹 API 동작 원리](#4-웹-api-동작-원리)
+5. [주요 기능 구현](#5-주요-기능-구현)
+6. [데이터 흐름 예시](#6-데이터-흐름-예시)
+7. [초보자를 위한 핵심 개념](#7-초보자를-위한-핵심-개념)
+8. [실습 예제](#8-실습-예제)
+
+---
+
+## 1. 프로젝트 개요
+
+### 1.1 디스코드잇이란?
+
+**디스코드잇(DiscoDeIt)**은 Discord와 유사한 메시징 플랫폼을 학습 목적으로 구현한 프로젝트입니다.
+
+**주요 기능:**
+- 👤 **사용자 관리**: 회원가입, 로그인, 프로필 관리
+- 💬 **채널 관리**: 공개/비공개 채널 생성 및 관리
+- 📨 **메시지 관리**: 메시지 전송, 수정, 삭제
+- 📎 **파일 관리**: 프로필 이미지, 첨부파일 업로드
+- 👀 **읽기 상태**: 메시지 읽음/안읽음 추적
+- 🟢 **온라인 상태**: 사용자 온라인/오프라인 표시
+
+### 1.2 기술 스택
+
+| 분류 | 기술 |
+|------|------|
+| **프레임워크** | Spring Boot 3.x |
+| **언어** | Java 17+ |
+| **빌드 도구** | Gradle |
+| **데이터 저장** | Java Collection Framework (HashMap) - 메모리 기반 |
+| **API 스타일** | REST API |
+| **직렬화** | Jackson (JSON) |
+
+### 1.3 왜 메모리 기반인가?
+
+**학습 목적:**
+- JPA나 데이터베이스 설정 없이 빠르게 시작 가능
+- 데이터 저장 로직을 직접 구현하면서 Repository 패턴 이해
+- 나중에 JPA로 쉽게 교체 가능한 구조
+
+**실무에서는:**
+- 실제 프로젝트에서는 MySQL, PostgreSQL 등의 데이터베이스 사용
+- Spring Data JPA로 Repository 자동 생성
+- 트랜잭션 관리 및 데이터 영속성 보장
+
+---
+
+## 2. 전체 아키텍처
+
+### 2.1 계층형 아키텍처 (Layered Architecture)
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                   Client (Postman, 브라우저)                │
+│                      HTTP 요청/응답                         │
+└────────────────────────┬────────────────────────────────────┘
+                         │ JSON
+                         ↓
+┌─────────────────────────────────────────────────────────────┐
+│              🎯 Controller Layer (REST API)                 │
+│   - UserController, ChannelController, MessageController    │
+│   - HTTP 요청을 받아서 적절한 Service 메서드 호출          │
+│   - Service 결과를 HTTP 응답으로 변환                      │
+└────────────────────────┬────────────────────────────────────┘
+                         │ DTO (Request, Response)
+                         ↓
+┌─────────────────────────────────────────────────────────────┐
+│                 💼 Service Layer (비즈니스 로직)            │
+│        - BasicUserService, BasicChannelService...           │
+│        - 비즈니스 규칙 검증 (중복 체크, 권한 확인)         │
+│        - 여러 Repository 조합하여 복잡한 로직 구현         │
+│        - Entity ↔ DTO 변환                                  │
+└────────────────────────┬────────────────────────────────────┘
+                         │ Entity
+                         ↓
+┌─────────────────────────────────────────────────────────────┐
+│              💾 Repository Layer (데이터 접근)              │
+│     - JCFUserRepository, JCFChannelRepository...            │
+│     - HashMap을 사용한 CRUD 연산                           │
+│     - 데이터 검색 및 필터링                                │
+└────────────────────────┬────────────────────────────────────┘
+                         │ HashMap (메모리)
+                         ↓
+┌─────────────────────────────────────────────────────────────┐
+│                🗂️ Entity Layer (도메인 모델)                │
+│        - User, Channel, Message, ReadStatus...              │
+│        - 비즈니스 데이터 구조 정의                         │
+│        - 엔티티 내부 로직 (update, isOnline 등)            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 2.2 각 계층의 역할
+
+| 계층 | 역할 | 예시 |
+|------|------|------|
+| **Controller** | HTTP 요청 처리 및 응답 반환 | `POST /users` → `createUser()` |
+| **Service** | 비즈니스 로직 실행 | 중복 체크, 데이터 변환, 연관 데이터 처리 |
+| **Repository** | 데이터 저장/조회 | `save()`, `findById()`, `delete()` |
+| **Entity** | 데이터 모델 정의 | `User`, `Channel`, `Message` |
+
+### 2.3 의존성 방향
+
+```
+Controller → Service → Repository → Entity
+
+각 계층은 바로 아래 계층만 의존
+Controller는 Repository를 직접 사용하지 않음
+Service는 여러 Repository를 조합 가능
+```
+
+---
+
+## 3. 계층별 상세 설명
+
+### 3.1 Entity Layer (도메인 모델)
+
+**위치:** `src/main/java/com/sprint/mission/discodeit/entity/`
+
+#### 3.1.1 BaseEntity
+
+모든 엔티티의 공통 속성을 정의합니다.
+
+```java
+public class BaseEntity {
+    private UUID id;              // 고유 식별자
+    private Instant createdAt;    // 생성 시간
+    private Instant updatedAt;    // 수정 시간
+
+    // 수정 시간 자동 갱신
+    protected void updateTimeStamp() {
+        this.updatedAt = Instant.now();
+    }
+}
+```
+
+**왜 BaseEntity가 필요한가?**
+- 모든 테이블에 공통으로 필요한 필드 중복 제거
+- 생성/수정 시간 자동 관리
+- 코드 재사용성 향상
+
+#### 3.1.2 User (사용자)
+
+```java
+@Getter
+public class User extends BaseEntity {
+    private String username;    // 사용자명 (로그인 ID)
+    private String email;       // 이메일
+    private String password;    // 비밀번호 (실무: 암호화 필요)
+    private UUID profileId;     // 프로필 이미지 ID (BinaryContent 참조)
+
+    public void update(String username, String email,
+                       String password, UUID profileId) {
+        // null이 아닌 값만 업데이트
+        if (username != null) this.username = username;
+        if (email != null) this.email = email;
+        // ...
+        updateTimeStamp(); // 수정 시간 갱신
+    }
+}
+```
+
+**핵심 포인트:**
+- `@Getter`: Lombok으로 getter 메서드 자동 생성
+- `profileId`: 프로필 이미지를 직접 저장하지 않고 ID만 참조
+- `update()`: 부분 업데이트 지원 (null 값은 유지)
+
+#### 3.1.3 Channel (채널)
+
+```java
+@Getter
+public class Channel extends BaseEntity {
+    private ChannelType type;    // PUBLIC 또는 PRIVATE
+    private String name;         // 채널 이름
+    private String description;  // 채널 설명
+
+    // PUBLIC 채널 생성자
+    public Channel(String name, String description) {
+        super();
+        this.type = ChannelType.PUBLIC;
+        this.name = name;
+        this.description = description;
+    }
+
+    // PRIVATE 채널 생성자
+    public Channel() {
+        super();
+        this.type = ChannelType.PRIVATE;
+    }
+}
+```
+
+**채널 타입 차이:**
+- **PUBLIC**: 모든 사용자가 접근 가능, 이름과 설명이 있음
+- **PRIVATE**: 초대된 사용자만 접근, 이름 없음 (1:1 또는 그룹 DM)
+
+#### 3.1.4 Message (메시지)
+
+```java
+@Getter
+public class Message extends BaseEntity {
+    private String content;           // 메시지 내용
+    private UUID channelId;           // 어느 채널의 메시지인지
+    private UUID authorId;            // 누가 작성했는지
+    private List<UUID> attachmentIds; // 첨부파일 ID 목록
+
+    public void update(String content) {
+        if (content != null) {
+            this.content = content;
+            updateTimeStamp();
+        }
+    }
+}
+```
+
+**관계:**
+- `channelId` → Channel 참조
+- `authorId` → User 참조
+- `attachmentIds` → BinaryContent 목록 참조
+
+#### 3.1.5 UserStatus (사용자 상태)
+
+```java
+@Getter
+public class UserStatus extends BaseEntity {
+    private UUID userId;              // 사용자 ID
+    private Instant lastActiveAt;     // 마지막 활동 시간
+
+    // 5분 이내 활동했으면 온라인
+    public boolean isOnline() {
+        return Duration.between(lastActiveAt, Instant.now())
+                       .toMinutes() < 5;
+    }
+}
+```
+
+**온라인 판단 로직:**
+- 마지막 활동 시간이 현재로부터 5분 이내 → 온라인
+- 5분 이상 경과 → 오프라인
+
+#### 3.1.6 ReadStatus (읽기 상태)
+
+```java
+@Getter
+public class ReadStatus extends BaseEntity {
+    private UUID userId;           // 사용자 ID
+    private UUID channelId;        // 채널 ID
+    private Instant lastReadAt;    // 마지막으로 읽은 시간
+}
+```
+
+**두 가지 역할:**
+1. **PRIVATE 채널 접근 제어**: ReadStatus가 있는 사용자만 채널 볼 수 있음
+2. **메시지 읽음 추적**: 언제 마지막으로 메시지를 읽었는지 기록
+
+---
+
+### 3.2 Repository Layer (데이터 접근)
+
+**위치:** `src/main/java/com/sprint/mission/discodeit/repository/jcf/`
+
+#### 3.2.1 Repository 인터페이스
+
+```java
+public interface UserRepository {
+    User save(User user);                     // 저장
+    Optional<User> findById(UUID id);         // ID로 조회
+    Optional<User> findByUsername(String username); // username으로 조회
+    List<User> findAll();                     // 전체 조회
+    void deleteById(UUID id);                 // 삭제
+    boolean existsByUsername(String username); // 중복 체크
+}
+```
+
+**왜 인터페이스를 사용하는가?**
+- JCF 구현체를 나중에 JPA 구현체로 쉽게 교체 가능
+- 테스트 시 Mock 객체 사용 가능
+- 코드 의존성을 인터페이스에만 두어 결합도 낮춤
+
+#### 3.2.2 JCF 구현체
+
+```java
+@Repository
+@ConditionalOnProperty(
+    name = "discodeit.repository.type",
+    havingValue = "jcf",
+    matchIfMissing = true
+)
+public class JCFUserRepository implements UserRepository {
+    // HashMap으로 메모리에 데이터 저장
+    private final Map<UUID, User> data = new HashMap<>();
+
+    @Override
+    public User save(User user) {
+        data.put(user.getId(), user);
+        return user;
+    }
+
+    @Override
+    public Optional<User> findById(UUID id) {
+        return Optional.ofNullable(data.get(id));
+    }
+
+    @Override
+    public Optional<User> findByUsername(String username) {
+        return data.values().stream()
+                .filter(user -> user.getUsername().equals(username))
+                .findFirst();
+    }
+
+    // ... 기타 메서드
+}
+```
+
+**핵심 포인트:**
+- `@ConditionalOnProperty`: 설정에 따라 이 구현체 활성화
+- `HashMap<UUID, User>`: ID를 키로 사용하여 빠른 조회
+- `Stream API`: 복잡한 검색 조건 처리 (username, email 등)
+
+**장단점:**
+
+| 장점 | 단점 |
+|------|------|
+| ✅ 설정 없이 바로 사용 가능 | ❌ 서버 재시작 시 데이터 손실 |
+| ✅ 빠른 CRUD 연산 (메모리) | ❌ 동시성 문제 (HashMap은 thread-safe 하지 않음) |
+| ✅ 학습용으로 이해하기 쉬움 | ❌ 메모리 용량 제한 |
+
+---
+
+### 3.3 Service Layer (비즈니스 로직)
+
+**위치:** `src/main/java/com/sprint/mission/discodeit/service/basic/`
+
+#### 3.3.1 BasicUserService
+
+```java
+@Service
+@RequiredArgsConstructor
+public class BasicUserService implements UserService {
+    private final UserRepository userRepository;
+    private final BinaryContentRepository binaryContentRepository;
+    private final UserStatusRepository userStatusRepository;
+
+    @Override
+    public UserResponse create(UserCreateRequest request,
+                               BinaryContentCreateRequest profileRequest) {
+        // 1. 비즈니스 규칙 검증
+        if (userRepository.existsByUsername(request.username())) {
+            throw new IllegalArgumentException(
+                "이 사용자 이름은 이미 존재해요!: " + request.username()
+            );
+        }
+
+        if (userRepository.existsByEmail(request.email())) {
+            throw new IllegalArgumentException(
+                "이 이메일은 이미 존재해요!: " + request.email()
+            );
+        }
+
+        // 2. 프로필 이미지 저장 (있는 경우)
+        UUID profileId = null;
+        if (profileRequest != null) {
+            BinaryContent profile = new BinaryContent(
+                profileRequest.fileName(),
+                profileRequest.contentType(),
+                profileRequest.data()
+            );
+            profileId = binaryContentRepository.save(profile).getId();
+        }
+
+        // 3. User 엔티티 생성 및 저장
+        User user = new User(
+            request.username(),
+            request.email(),
+            request.password(),
+            profileId
+        );
+        User savedUser = userRepository.save(user);
+
+        // 4. UserStatus 생성 (초기값: 현재 시간)
+        UserStatus userStatus = new UserStatus(
+            savedUser.getId(),
+            Instant.now()
+        );
+        userStatusRepository.save(userStatus);
+
+        // 5. Entity를 DTO로 변환하여 반환
+        return toUserResponse(savedUser, true);
+    }
+
+    private UserResponse toUserResponse(User user, boolean isOnline) {
+        return new UserResponse(
+            user.getId(),
+            user.getUsername(),
+            user.getEmail(),
+            user.getProfileId(),
+            isOnline,  // 비밀번호는 제외!
+            user.getCreatedAt(),
+            user.getUpdatedAt()
+        );
+    }
+}
+```
+
+**Service Layer의 핵심 역할:**
+
+1. **비즈니스 규칙 검증**
+   - 중복 체크 (username, email)
+   - 권한 확인
+   - 데이터 유효성 검사
+
+2. **여러 Repository 조합**
+   - User + BinaryContent + UserStatus를 함께 관리
+   - 트랜잭션 단위 작업 (실무에서는 `@Transactional`)
+
+3. **Entity ↔ DTO 변환**
+   - 비밀번호 같은 민감 정보 제외
+   - 추가 정보 계산 (isOnline)
+
+#### 3.3.2 BasicChannelService
+
+```java
+@Service
+@RequiredArgsConstructor
+public class BasicChannelService implements ChannelService {
+    private final ChannelRepository channelRepository;
+    private final ReadStatusRepository readStatusRepository;
+    private final MessageRepository messageRepository;
+    private final BinaryContentRepository binaryContentRepository;
+
+    @Override
+    public ChannelResponse createPrivate(PrivateChannelCreateRequest request) {
+        // 1. PRIVATE 채널 생성
+        Channel channel = new Channel(); // 이름 없는 PRIVATE 채널
+        Channel savedChannel = channelRepository.save(channel);
+
+        // 2. 각 참여자에게 ReadStatus 생성 (접근 권한 부여)
+        for (UUID memberId : request.memberIds()) {
+            ReadStatus readStatus = new ReadStatus(
+                memberId,
+                savedChannel.getId(),
+                Instant.now()
+            );
+            readStatusRepository.save(readStatus);
+        }
+
+        return toChannelResponse(savedChannel);
+    }
+
+    @Override
+    public void delete(UUID id) {
+        // 연쇄 삭제 (Cascade Delete)
+        Channel channel = channelRepository.findById(id)
+                .orElseThrow(() -> new NoSuchElementException(
+                    "Channel not found: " + id
+                ));
+
+        // 1. 채널의 메시지 조회
+        List<Message> messages = messageRepository.findAllByChannelId(id);
+
+        // 2. 각 메시지의 첨부파일 삭제
+        for (Message message : messages) {
+            for (UUID attachmentId : message.getAttachmentIds()) {
+                binaryContentRepository.deleteById(attachmentId);
+            }
+        }
+
+        // 3. 메시지 일괄 삭제
+        messageRepository.deleteAllByChannelId(id);
+
+        // 4. ReadStatus 일괄 삭제
+        readStatusRepository.deleteAllByChannelId(id);
+
+        // 5. 최종적으로 채널 삭제
+        channelRepository.deleteById(id);
+    }
+}
+```
+
+**PRIVATE 채널의 접근 제어:**
+
+```java
+@Override
+public List<ChannelResponse> findAllByUserId(UUID userId) {
+    List<Channel> allChannels = channelRepository.findAll();
+
+    return allChannels.stream()
+            .filter(channel -> {
+                if (channel.getType() == ChannelType.PUBLIC) {
+                    return true; // PUBLIC은 모두 접근 가능
+                }
+                // PRIVATE은 ReadStatus가 있어야 접근 가능
+                return readStatusRepository
+                        .findByUserIdAndChannelId(userId, channel.getId())
+                        .isPresent();
+            })
+            .map(this::toChannelResponse)
+            .toList();
+}
+```
+
+**연쇄 삭제 순서가 중요한 이유:**
+1. 첨부파일 먼저 삭제 (메시지가 참조하기 때문)
+2. 메시지 삭제 (채널이 참조하기 때문)
+3. ReadStatus 삭제 (채널을 참조하기 때문)
+4. 마지막에 채널 삭제
+
+---
+
+### 3.4 Controller Layer (REST API)
+
+**위치:** `src/main/java/com/sprint/mission/discodeit/controller/`
+
+#### 3.4.1 UserController
+
+```java
+@RestController
+@RequestMapping("/users")
+@RequiredArgsConstructor
+public class UserController {
+    private final UserService userService;
+    private final UserStatusService userStatusService;
+
+    /**
+     * 사용자 등록
+     * POST /users
+     *
+     * 요청 본문:
+     * {
+     *   "username": "user1",
+     *   "email": "user1@example.com",
+     *   "password": "password123"
+     * }
+     *
+     * 응답: 201 Created + UserResponse
+     */
+    @RequestMapping(method = RequestMethod.POST)
+    public ResponseEntity<UserResponse> createUser(
+            @RequestBody UserCreateRequest userRequest
+    ) {
+        UserResponse user = userService.create(userRequest, null);
+        return ResponseEntity.status(HttpStatus.CREATED).body(user);
+    }
+
+    /**
+     * 전체 사용자 조회
+     * GET /users
+     *
+     * 응답: 200 OK + List<UserResponse>
+     */
+    @RequestMapping(method = RequestMethod.GET)
+    public ResponseEntity<List<UserResponse>> getAllUsers() {
+        List<UserResponse> users = userService.findAll();
+        return ResponseEntity.ok(users);
+    }
+
+    /**
+     * 사용자 온라인 상태 업데이트
+     * PUT /users/{id}/status
+     *
+     * 요청 본문:
+     * {
+     *   "lastActiveAt": "2024-01-15T10:30:00Z"
+     * }
+     *
+     * 응답: 200 OK + UserStatus
+     */
+    @RequestMapping(method = RequestMethod.PUT, value = "/{id}/status")
+    public ResponseEntity<UserStatus> updateUserStatus(
+            @PathVariable UUID id,
+            @RequestBody UserStatusUpdateRequest request
+    ) {
+        UserStatus userStatus = userStatusService.updateByUserId(id, request);
+        return ResponseEntity.ok(userStatus);
+    }
+}
+```
+
+**Spring MVC 주요 어노테이션:**
+
+| 어노테이션 | 역할 | 예시 |
+|-----------|------|------|
+| `@RestController` | REST API 컨트롤러임을 표시 | JSON 응답 자동 변환 |
+| `@RequestMapping("/users")` | 기본 URL 경로 | 모든 메서드에 `/users` 접두사 |
+| `@RequestBody` | HTTP 요청 본문을 Java 객체로 변환 | JSON → UserCreateRequest |
+| `@PathVariable` | URL 경로의 변수 추출 | `/users/{id}` → `UUID id` |
+| `@RequestParam` | 쿼리 파라미터 추출 | `?userId=xxx` → `UUID userId` |
+
+**HTTP 상태 코드:**
+
+| 상태 코드 | 의미 | 사용 시점 |
+|----------|------|----------|
+| **200 OK** | 성공 | 조회, 수정 성공 |
+| **201 Created** | 생성 성공 | 사용자 등록, 채널 생성 |
+| **204 No Content** | 성공 (응답 본문 없음) | 삭제 성공 |
+| **404 Not Found** | 리소스 없음 | 존재하지 않는 ID 조회 |
+| **400 Bad Request** | 잘못된 요청 | 유효성 검사 실패 |
+
+#### 3.4.2 ChannelController
+
+```java
+@RestController
+@RequestMapping("/channels")
+@RequiredArgsConstructor
+public class ChannelController {
+    private final ChannelService channelService;
+
+    /**
+     * 공개 채널 생성
+     * POST /channels/public
+     */
+    @RequestMapping(method = RequestMethod.POST, value = "/public")
+    public ResponseEntity<ChannelResponse> createPublicChannel(
+            @RequestBody PublicChannelCreateRequest request
+    ) {
+        ChannelResponse channel = channelService.createPublic(request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(channel);
+    }
+
+    /**
+     * 비공개 채널 생성
+     * POST /channels/private
+     */
+    @RequestMapping(method = RequestMethod.POST, value = "/private")
+    public ResponseEntity<ChannelResponse> createPrivateChannel(
+            @RequestBody PrivateChannelCreateRequest request
+    ) {
+        ChannelResponse channel = channelService.createPrivate(request);
+        return ResponseEntity.status(HttpStatus.CREATED).body(channel);
+    }
+
+    /**
+     * 사용자가 볼 수 있는 채널 조회
+     * GET /channels?userId={userId}
+     */
+    @RequestMapping(method = RequestMethod.GET)
+    public ResponseEntity<List<ChannelResponse>> getChannelsByUser(
+            @RequestParam UUID userId
+    ) {
+        List<ChannelResponse> channels = channelService.findAllByUserId(userId);
+        return ResponseEntity.ok(channels);
+    }
+}
+```
+
+---
+
+### 3.5 DTO Layer (데이터 전송 객체)
+
+**위치:** `src/main/java/com/sprint/mission/discodeit/dto/`
+
+#### 3.5.1 Request DTO
+
+```java
+// 사용자 생성 요청
+public record UserCreateRequest(
+    String username,
+    String email,
+    String password
+) {}
+
+// 로그인 요청
+public record LoginRequest(
+    String username,
+    String password
+) {}
+
+// 메시지 전송 요청
+public record MessageCreateRequest(
+    String content,
+    UUID channelId,
+    UUID authorId
+) {}
+```
+
+**Java Record의 장점:**
+- 불변 객체 (Immutable)
+- getter 자동 생성 (`request.username()`)
+- `equals()`, `hashCode()`, `toString()` 자동 생성
+- 간결한 코드
+
+#### 3.5.2 Response DTO
+
+```java
+// 사용자 응답
+public record UserResponse(
+    UUID id,
+    String username,
+    String email,
+    UUID profileId,
+    boolean isOnline,    // 계산된 값
+    Instant createdAt,
+    Instant updatedAt
+    // password는 포함하지 않음!
+) {}
+
+// 채널 응답
+public record ChannelResponse(
+    UUID id,
+    ChannelType type,
+    String name,
+    String description,
+    List<UUID> participantIds,
+    Instant lastMessageAt,
+    Instant createdAt,
+    Instant updatedAt
+) {}
+```
+
+**Entity vs DTO 차이:**
+
+| 구분 | Entity | DTO |
+|------|--------|-----|
+| **목적** | 데이터베이스 모델 | 네트워크 전송 |
+| **변경** | 가변 (Mutable) | 불변 (Immutable) |
+| **정보** | 모든 정보 포함 | 필요한 정보만 |
+| **민감 정보** | 포함 (password) | 제외 |
+| **추가 정보** | 없음 | 계산된 값 포함 (isOnline) |
+
+---
+
+## 4. 웹 API 동작 원리
+
+### 4.1 HTTP 요청부터 응답까지의 흐름
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 1️⃣ HTTP 요청                                                │
+│    POST http://localhost:8080/users                         │
+│    Content-Type: application/json                           │
+│    Body: {"username":"user1","email":"...","password":"..."} │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓ Jackson이 JSON을 Java 객체로 변환
+┌─────────────────────────────────────────────────────────────┐
+│ 2️⃣ Spring MVC (DispatcherServlet)                           │
+│    - URL 매핑 확인: /users → UserController                 │
+│    - HTTP 메서드 확인: POST → createUser()                  │
+│    - @RequestBody로 UserCreateRequest 객체 생성             │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓
+┌─────────────────────────────────────────────────────────────┐
+│ 3️⃣ UserController.createUser()                              │
+│    @RequestMapping(method = RequestMethod.POST)             │
+│    public ResponseEntity<UserResponse> createUser(          │
+│        @RequestBody UserCreateRequest request               │
+│    ) {                                                      │
+│        UserResponse user = userService.create(request, null);│
+│        return ResponseEntity.status(201).body(user);        │
+│    }                                                        │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓ Service 호출
+┌─────────────────────────────────────────────────────────────┐
+│ 4️⃣ BasicUserService.create()                                │
+│    1. 중복 체크 (userRepository.existsByUsername)           │
+│    2. 프로필 이미지 저장 (binaryContentRepository.save)     │
+│    3. User 엔티티 생성 및 저장 (userRepository.save)        │
+│    4. UserStatus 생성 및 저장 (userStatusRepository.save)   │
+│    5. UserResponse DTO로 변환하여 반환                      │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓ Repository 호출
+┌─────────────────────────────────────────────────────────────┐
+│ 5️⃣ JCFUserRepository.save()                                 │
+│    private Map<UUID, User> data = new HashMap<>();          │
+│                                                             │
+│    public User save(User user) {                           │
+│        data.put(user.getId(), user);                       │
+│        return user;                                        │
+│    }                                                        │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓ 데이터 저장 완료
+┌─────────────────────────────────────────────────────────────┐
+│ 6️⃣ UserResponse 반환                                        │
+│    Service → Controller로 UserResponse 반환                 │
+│    {                                                        │
+│      "id": "uuid-value",                                   │
+│      "username": "user1",                                  │
+│      "email": "user1@example.com",                         │
+│      "isOnline": true,                                     │
+│      "createdAt": "2024-01-15T10:30:00Z"                   │
+│    }                                                        │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ↓ Jackson이 Java 객체를 JSON으로 변환
+┌─────────────────────────────────────────────────────────────┐
+│ 7️⃣ HTTP 응답                                                │
+│    HTTP/1.1 201 Created                                    │
+│    Content-Type: application/json                          │
+│    Body: {"id":"...","username":"user1",...}               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 4.2 Spring Boot의 자동 처리 기능
+
+**Spring Boot가 자동으로 해주는 일:**
+
+1. **JSON ↔ Java 객체 변환 (Jackson)**
+   - 요청: JSON → `UserCreateRequest`
+   - 응답: `UserResponse` → JSON
+
+2. **의존성 주입 (Dependency Injection)**
+   - `@RequiredArgsConstructor`로 생성자 자동 생성
+   - Controller에 Service 자동 주입
+   - Service에 Repository 자동 주입
+
+3. **HTTP 상태 코드 설정**
+   - `ResponseEntity.status(HttpStatus.CREATED)` → `201 Created`
+   - `ResponseEntity.ok()` → `200 OK`
+
+4. **예외 처리 (GlobalExceptionHandler)**
+   - `NoSuchElementException` → `404 Not Found`
+   - `IllegalArgumentException` → `400 Bad Request`
+
+---
+
+## 5. 주요 기능 구현
+
+### 5.1 사용자 인증 (로그인)
+
+```java
+@Service
+@RequiredArgsConstructor
+public class BasicAuthService implements AuthService {
+    private final UserRepository userRepository;
+    private final UserStatusRepository userStatusRepository;
+
+    @Override
+    public UserResponse login(LoginRequest request) {
+        // 1. username으로 사용자 검색
+        User user = userRepository.findByUsername(request.username())
+                .orElseThrow(() -> new NoSuchElementException(
+                    "User not found with username: " + request.username()
+                ));
+
+        // 2. 비밀번호 검증 (실무에서는 암호화된 비밀번호 비교)
+        if (!user.getPassword().equals(request.password())) {
+            throw new IllegalArgumentException("Invalid password");
+        }
+
+        // 3. 온라인 상태 조회
+        boolean isOnline = userStatusRepository.findByUserId(user.getId())
+                .map(UserStatus::isOnline)
+                .orElse(false);
+
+        // 4. UserResponse 반환
+        return new UserResponse(
+            user.getId(),
+            user.getUsername(),
+            user.getEmail(),
+            user.getProfileId(),
+            isOnline,
+            user.getCreatedAt(),
+            user.getUpdatedAt()
+        );
+    }
+}
+```
+
+**실무와의 차이:**
+- **현재**: 평문 비밀번호 비교 (`password.equals()`)
+- **실무**: BCrypt, Argon2 등으로 암호화된 비밀번호 비교
+- **실무**: JWT 토큰 발급, 세션 관리
+
+### 5.2 PRIVATE 채널 생성
+
+```java
+@Override
+public ChannelResponse createPrivate(PrivateChannelCreateRequest request) {
+    // 1. PRIVATE 채널 생성 (이름 없음)
+    Channel channel = new Channel(); // type = PRIVATE
+    Channel savedChannel = channelRepository.save(channel);
+
+    // 2. 각 참여자에게 ReadStatus 생성 (접근 권한 부여)
+    for (UUID memberId : request.memberIds()) {
+        ReadStatus readStatus = new ReadStatus(
+            memberId,
+            savedChannel.getId(),
+            Instant.now()
+        );
+        readStatusRepository.save(readStatus);
+    }
+
+    // 3. ChannelResponse 반환
+    return new ChannelResponse(
+        savedChannel.getId(),
+        savedChannel.getType(),
+        null, // PRIVATE 채널은 이름 없음
+        null, // 설명도 없음
+        request.memberIds(), // 참여자 목록
+        null,
+        savedChannel.getCreatedAt(),
+        savedChannel.getUpdatedAt()
+    );
+}
+```
+
+**ReadStatus의 역할:**
+- PRIVATE 채널 생성 시 각 참여자에게 ReadStatus 생성
+- 나중에 채널 조회 시 ReadStatus로 접근 권한 확인
+
+### 5.3 메시지 전송 및 첨부파일
+
+```java
+@Override
+public MessageResponse create(MessageCreateRequest request,
+                               List<BinaryContentCreateRequest> attachmentRequests) {
+    // 1. 첨부파일 저장
+    List<UUID> attachmentIds = new ArrayList<>();
+    if (attachmentRequests != null) {
+        for (BinaryContentCreateRequest attachmentRequest : attachmentRequests) {
+            BinaryContent attachment = new BinaryContent(
+                attachmentRequest.fileName(),
+                attachmentRequest.contentType(),
+                attachmentRequest.data()
+            );
+            UUID attachmentId = binaryContentRepository.save(attachment).getId();
+            attachmentIds.add(attachmentId);
+        }
+    }
+
+    // 2. Message 엔티티 생성 및 저장
+    Message message = new Message(
+        request.content(),
+        request.channelId(),
+        request.authorId(),
+        attachmentIds
+    );
+    Message savedMessage = messageRepository.save(message);
+
+    // 3. MessageResponse 반환
+    return toMessageResponse(savedMessage);
+}
+```
+
+**첨부파일 처리 순서:**
+1. 첨부파일을 먼저 BinaryContent로 저장
+2. 저장된 파일의 ID 목록 수집
+3. Message 엔티티에 ID 목록 저장
+
+---
+
+## 6. 데이터 흐름 예시
+
+### 6.1 사용자 등록 전체 흐름
+
+```
+[Postman]
+POST http://localhost:8080/users
+Body: {
+  "username": "alice",
+  "email": "alice@example.com",
+  "password": "pass123"
+}
+
+↓ HTTP 요청
+
+[UserController]
+createUser(UserCreateRequest)
+  ↓ Service 호출
+
+[BasicUserService]
+create(UserCreateRequest, null)
+  ├─ userRepository.existsByUsername("alice") → false ✅
+  ├─ userRepository.existsByEmail("alice@example.com") → false ✅
+  ├─ new User("alice", "alice@example.com", "pass123", null)
+  ├─ userRepository.save(user)
+  │   ↓
+  │  [JCFUserRepository]
+  │  data.put(user.getId(), user) → HashMap에 저장
+  │   ↑
+  ├─ new UserStatus(userId, Instant.now())
+  ├─ userStatusRepository.save(userStatus)
+  │   ↓
+  │  [JCFUserStatusRepository]
+  │  data.put(userStatus.getId(), userStatus)
+  │   ↑
+  └─ toUserResponse(user, true)
+      ↓
+
+[UserController]
+ResponseEntity.status(201).body(userResponse)
+  ↓ HTTP 응답
+
+[Postman]
+HTTP/1.1 201 Created
+{
+  "id": "uuid-generated",
+  "username": "alice",
+  "email": "alice@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2024-01-15T10:30:00Z",
+  "updatedAt": "2024-01-15T10:30:00Z"
+}
+```
+
+### 6.2 채널 삭제 전체 흐름 (연쇄 삭제)
+
+```
+[Postman]
+DELETE http://localhost:8080/channels/{channelId}
+
+↓
+
+[ChannelController]
+deleteChannel(UUID id)
+  ↓
+
+[BasicChannelService]
+delete(UUID id)
+  ├─ channelRepository.findById(id) → Channel 확인
+  │
+  ├─ messageRepository.findAllByChannelId(id) → 메시지 목록 조회
+  │   [메시지1, 메시지2, 메시지3]
+  │
+  ├─ for (Message message : messages) {
+  │     for (UUID attachmentId : message.getAttachmentIds()) {
+  │       ├─ binaryContentRepository.deleteById(attachmentId)
+  │       │   ↓
+  │       │  [JCFBinaryContentRepository]
+  │       │  data.remove(attachmentId) → 첨부파일 삭제
+  │       │   ↑
+  │     }
+  │   }
+  │
+  ├─ messageRepository.deleteAllByChannelId(id)
+  │   ↓
+  │  [JCFMessageRepository]
+  │  data.values().removeIf(m -> m.getChannelId().equals(id))
+  │   ↑
+  │
+  ├─ readStatusRepository.deleteAllByChannelId(id)
+  │   ↓
+  │  [JCFReadStatusRepository]
+  │  data.values().removeIf(r -> r.getChannelId().equals(id))
+  │   ↑
+  │
+  └─ channelRepository.deleteById(id)
+      ↓
+     [JCFChannelRepository]
+     data.remove(id) → 채널 삭제
+      ↑
+
+[ChannelController]
+ResponseEntity.noContent().build()
+  ↓
+
+[Postman]
+HTTP/1.1 204 No Content
+```
+
+**삭제 순서가 중요한 이유:**
+- 메시지가 첨부파일을 참조하므로 첨부파일을 먼저 삭제
+- 채널이 메시지와 ReadStatus를 참조하므로 이들을 먼저 삭제
+- 참조 무결성 유지
+
+---
+
+## 7. 초보자를 위한 핵심 개념
+
+### 7.1 왜 계층을 나누는가?
+
+**관심사의 분리 (Separation of Concerns)**
+
+```
+만약 계층을 나누지 않는다면?
+
+UserController {
+    public UserResponse createUser(UserCreateRequest request) {
+        // HTTP 처리 + 비즈니스 로직 + 데이터 접근이 섞여있음
+        if (data.containsKey(request.username())) { // 데이터 접근
+            throw new Exception("중복!"); // 비즈니스 로직
+        }
+        User user = new User(...);
+        data.put(user.getId(), user); // 데이터 접근
+        return new UserResponse(...); // HTTP 응답
+    }
+}
+
+문제점:
+❌ 코드가 복잡하고 이해하기 어려움
+❌ 테스트하기 어려움
+❌ 데이터베이스 변경 시 Controller도 수정해야 함
+❌ 재사용 불가능 (다른 Controller에서 같은 로직 필요 시 복사해야 함)
+```
+
+**계층을 나눈 경우:**
+
+```
+Controller: HTTP만 처리
+  ↓
+Service: 비즈니스 로직만 처리
+  ↓
+Repository: 데이터 접근만 처리
+
+장점:
+✅ 각 계층이 하나의 책임만 가짐 (Single Responsibility Principle)
+✅ 테스트하기 쉬움 (Mock 객체 사용)
+✅ 재사용 가능 (Service는 여러 Controller에서 사용)
+✅ 유지보수 쉬움 (변경 시 해당 계층만 수정)
+```
+
+### 7.2 왜 DTO를 사용하는가?
+
+**Entity를 직접 반환하면 안 되는 이유:**
+
+```java
+// ❌ 나쁜 예: Entity를 직접 반환
+@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+public User getUser(@PathVariable UUID id) {
+    return userRepository.findById(id).get();
+}
+
+// 응답:
+{
+  "id": "uuid",
+  "username": "alice",
+  "email": "alice@example.com",
+  "password": "pass123",  // ❌ 비밀번호 노출!
+  "createdAt": "...",
+  "updatedAt": "..."
+  // isOnline 같은 계산된 값은 없음
+}
+```
+
+```java
+// ✅ 좋은 예: DTO 사용
+@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+public UserResponse getUser(@PathVariable UUID id) {
+    return userService.find(id);
+}
+
+// 응답:
+{
+  "id": "uuid",
+  "username": "alice",
+  "email": "alice@example.com",
+  // password 없음 ✅
+  "isOnline": true,  // ✅ 계산된 값 추가
+  "createdAt": "...",
+  "updatedAt": "..."
+}
+```
+
+**DTO의 장점:**
+1. **보안**: 민감 정보 제외 (비밀번호)
+2. **유연성**: 필요한 정보만 전송
+3. **확장성**: 계산된 값 추가 가능
+4. **안정성**: API 응답 구조를 독립적으로 관리
+
+### 7.3 왜 인터페이스를 사용하는가?
+
+```java
+// UserService 인터페이스
+public interface UserService {
+    UserResponse create(UserCreateRequest request, ...);
+    UserResponse find(UUID id);
+    // ...
+}
+
+// 구현체 1: 기본 구현
+@Service
+public class BasicUserService implements UserService {
+    // 비즈니스 로직 구현
+}
+
+// 나중에 구현체 2 추가 가능: 캐싱 추가
+@Service
+@Primary
+public class CachedUserService implements UserService {
+    private final BasicUserService basicUserService;
+    private final Cache cache;
+
+    public UserResponse find(UUID id) {
+        if (cache.has(id)) {
+            return cache.get(id);
+        }
+        UserResponse user = basicUserService.find(id);
+        cache.put(id, user);
+        return user;
+    }
+}
+```
+
+**장점:**
+- Controller는 인터페이스에만 의존 → 구현체 교체 가능
+- 테스트 시 Mock 구현체 사용 가능
+- 여러 구현체를 만들어 기능 확장 가능
+
+### 7.4 의존성 주입 (Dependency Injection)
+
+**수동 방식 (DI 없이):**
+
+```java
+public class UserController {
+    // ❌ 직접 객체 생성
+    private UserService userService = new BasicUserService(
+        new JCFUserRepository(),
+        new JCFBinaryContentRepository(),
+        new JCFUserStatusRepository()
+    );
+}
+
+문제점:
+❌ 결합도 높음 (특정 구현체에 의존)
+❌ 테스트 어려움
+❌ 설정 변경 시 코드 수정 필요
+```
+
+**Spring의 DI:**
+
+```java
+@RestController
+@RequiredArgsConstructor  // Lombok: final 필드로 생성자 자동 생성
+public class UserController {
+    // ✅ Spring이 자동으로 주입
+    private final UserService userService;
+}
+
+장점:
+✅ Spring이 객체 생성 및 주입 자동 처리
+✅ 인터페이스 타입으로 선언 → 구현체 교체 쉬움
+✅ 테스트 시 Mock 주입 가능
+```
+
+### 7.5 메모리 저장소의 한계와 해결책
+
+**현재 (JCF HashMap):**
+
+```java
+private final Map<UUID, User> data = new HashMap<>();
+```
+
+**문제점:**
+
+1. **데이터 손실**
+   - 서버 재시작 시 모든 데이터 삭제
+   - 해결: 데이터베이스 사용 (MySQL, PostgreSQL)
+
+2. **동시성 문제**
+   - HashMap은 thread-safe 하지 않음
+   - 여러 요청이 동시에 접근하면 데이터 손상 가능
+   - 해결: `ConcurrentHashMap` 또는 데이터베이스 트랜잭션
+
+3. **메모리 제한**
+   - 데이터가 많아지면 OutOfMemoryError
+   - 해결: 데이터베이스 + 페이징
+
+**실무 해결책 (JPA):**
+
+```java
+@Repository
+public interface UserRepository extends JpaRepository<User, UUID> {
+    Optional<User> findByUsername(String username);
+    boolean existsByUsername(String username);
+    // Spring Data JPA가 자동으로 구현 생성!
+}
+
+// application.yml
+spring:
+  datasource:
+    url: jdbc:mysql://localhost:3306/discodeit
+    username: root
+    password: password
+  jpa:
+    hibernate:
+      ddl-auto: update
+```
+
+---
+
+## 8. 실습 예제
+
+### 8.1 API 테스트 (Postman)
+
+#### 1단계: 사용자 등록
+
+```
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "alice",
+  "email": "alice@example.com",
+  "password": "password123"
+}
+
+응답 (201 Created):
+{
+  "id": "generated-uuid",
+  "username": "alice",
+  "email": "alice@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2024-01-15T10:30:00Z",
+  "updatedAt": "2024-01-15T10:30:00Z"
+}
+```
+
+#### 2단계: 로그인
+
+```
+POST http://localhost:8080/auth/login
+Content-Type: application/json
+
+{
+  "username": "alice",
+  "password": "password123"
+}
+
+응답 (200 OK):
+{
+  "id": "generated-uuid",
+  "username": "alice",
+  "email": "alice@example.com",
+  "isOnline": true,
+  ...
+}
+```
+
+#### 3단계: 공개 채널 생성
+
+```
+POST http://localhost:8080/channels/public
+Content-Type: application/json
+
+{
+  "name": "일반 대화",
+  "description": "자유롭게 대화하는 공간"
+}
+
+응답 (201 Created):
+{
+  "id": "channel-uuid",
+  "type": "PUBLIC",
+  "name": "일반 대화",
+  "description": "자유롭게 대화하는 공간",
+  ...
+}
+```
+
+#### 4단계: 메시지 전송
+
+```
+POST http://localhost:8080/messages
+Content-Type: application/json
+
+{
+  "content": "안녕하세요!",
+  "channelId": "channel-uuid",
+  "authorId": "alice-uuid"
+}
+
+응답 (201 Created):
+{
+  "id": "message-uuid",
+  "content": "안녕하세요!",
+  "channelId": "channel-uuid",
+  "authorId": "alice-uuid",
+  "attachmentIds": [],
+  ...
+}
+```
+
+#### 5단계: 채널의 메시지 조회
+
+```
+GET http://localhost:8080/messages?channelId=channel-uuid
+
+응답 (200 OK):
+[
+  {
+    "id": "message-uuid",
+    "content": "안녕하세요!",
+    "channelId": "channel-uuid",
+    "authorId": "alice-uuid",
+    ...
+  }
+]
+```
+
+### 8.2 코드 수정 실습
+
+#### 실습 1: 새로운 API 추가
+
+**목표: 사용자 이름으로 사용자 검색 API 추가**
+
+```java
+// 1. UserController에 메서드 추가
+@RequestMapping(method = RequestMethod.GET, value = "/search")
+public ResponseEntity<UserResponse> getUserByUsername(
+        @RequestParam String username
+) {
+    UserResponse user = userService.findByUsername(username);
+    return ResponseEntity.ok(user);
+}
+
+// 2. UserService 인터페이스에 메서드 선언
+public interface UserService {
+    // ... 기존 메서드들
+    UserResponse findByUsername(String username);
+}
+
+// 3. BasicUserService에 메서드 구현
+@Override
+public UserResponse findByUsername(String username) {
+    User user = userRepository.findByUsername(username)
+            .orElseThrow(() -> new NoSuchElementException(
+                "User not found with username: " + username
+            ));
+
+    boolean isOnline = getOnlineStatus(user.getId());
+    return toUserResponse(user, isOnline);
+}
+
+// 4. 테스트
+GET http://localhost:8080/users/search?username=alice
+```
+
+#### 실습 2: 비즈니스 로직 수정
+
+**목표: 온라인 기준을 5분에서 10분으로 변경**
+
+```java
+// UserStatus.java
+public boolean isOnline() {
+    return Duration.between(lastActiveAt, Instant.now())
+                   .toMinutes() < 10;  // 5 → 10으로 변경
+}
+```
+
+#### 실습 3: DTO 필드 추가
+
+**목표: UserResponse에 생성 후 경과 시간 추가**
+
+```java
+// UserResponse.java
+public record UserResponse(
+    UUID id,
+    String username,
+    String email,
+    UUID profileId,
+    boolean isOnline,
+    Instant createdAt,
+    Instant updatedAt,
+    long createdDaysAgo  // 새 필드 추가
+) {}
+
+// BasicUserService.java
+private UserResponse toUserResponse(User user, boolean isOnline) {
+    long daysAgo = Duration.between(user.getCreatedAt(), Instant.now())
+                           .toDays();
+
+    return new UserResponse(
+        user.getId(),
+        user.getUsername(),
+        user.getEmail(),
+        user.getProfileId(),
+        isOnline,
+        user.getCreatedAt(),
+        user.getUpdatedAt(),
+        daysAgo  // 계산된 값
+    );
+}
+```
+
+---
+
+## 🎓 학습 체크리스트
+
+### 이해했는지 확인해보세요:
+
+- [ ] **아키텍처**: 계층형 구조의 각 계층 역할을 설명할 수 있나요?
+- [ ] **Entity**: BaseEntity를 상속하는 이유를 아나요?
+- [ ] **Repository**: JCF 구현체가 HashMap을 사용하는 이유를 아나요?
+- [ ] **Service**: 비즈니스 로직이 왜 Service 계층에 있는지 아나요?
+- [ ] **Controller**: `@RequestMapping`, `@RequestBody`, `@PathVariable`의 역할을 아나요?
+- [ ] **DTO**: Entity를 직접 반환하지 않고 DTO를 사용하는 이유를 아나요?
+- [ ] **DI**: Spring이 어떻게 의존성을 자동 주입하는지 아나요?
+- [ ] **데이터 흐름**: HTTP 요청부터 응답까지의 전체 흐름을 설명할 수 있나요?
+- [ ] **연쇄 삭제**: 채널 삭제 시 메시지와 첨부파일을 먼저 삭제하는 이유를 아나요?
+- [ ] **PRIVATE 채널**: ReadStatus가 어떻게 접근 제어에 사용되는지 아나요?
+
+---
+
+## 📚 더 배우고 싶다면
+
+### 다음 단계:
+
+1. **JPA로 전환하기**
+   - Spring Data JPA 학습
+   - 데이터베이스 연동 (MySQL, PostgreSQL)
+   - 트랜잭션 관리 (`@Transactional`)
+
+2. **보안 추가하기**
+   - Spring Security 적용
+   - JWT 토큰 인증
+   - 비밀번호 암호화 (BCrypt)
+
+3. **테스트 작성하기**
+   - JUnit 5
+   - Mockito (Service 테스트)
+   - MockMvc (Controller 테스트)
+
+4. **실시간 기능 추가**
+   - WebSocket으로 실시간 메시지
+   - Server-Sent Events (SSE)
+
+5. **고급 기능**
+   - 파일 업로드 (Multipart)
+   - 페이징 및 정렬
+   - 검색 기능 (QueryDSL)
+   - 캐싱 (Redis)
+
+---
+
+## 🎉 마무리
+
+이 프로젝트는 **Spring Boot의 기본 개념들을 실제로 적용한 깔끔한 예제**입니다.
+
+**핵심 포인트:**
+- ✅ 계층형 아키텍처로 관심사 분리
+- ✅ Repository 패턴으로 데이터 접근 추상화
+- ✅ DTO로 API 응답 제어
+- ✅ Spring DI로 객체 관리 자동화
+
+**이 프로젝트를 이해했다면:**
+- 실무 Spring Boot 프로젝트의 70% 이상 이해 가능!
+- JPA, Security, WebSocket 등 추가 기술 학습 준비 완료!
+
+**Happy Coding! 🚀**
diff --git a/discodeit/docs/api-tests-with-env.http b/discodeit/docs/api-tests-with-env.http
new file mode 100644
index 00000000..a5ca640b
--- /dev/null
+++ b/discodeit/docs/api-tests-with-env.http
@@ -0,0 +1,321 @@
+### Discodeit API 테스트 (환경 변수 사용)
+### IntelliJ에서 각 요청 옆의 '▶' 버튼을 클릭하거나 Ctrl+Enter (Mac: Cmd+Enter)로 실행
+### 환경 선택: 우측 상단 드롭다운에서 'dev' 선택
+
+### ==========================================
+### 1. 사용자 관리 API
+### ==========================================
+
+### 1-1. 모든 사용자 조회
+GET {{baseUrl}}/users
+Accept: application/json
+
+### 1-2. 특정 사용자 조회 (한성재)
+GET {{baseUrl}}/users/{{user1Id}}
+Accept: application/json
+
+### 1-3. 특정 사용자 조회 (장현민)
+GET {{baseUrl}}/users/{{user3Id}}
+Accept: application/json
+
+### 1-4. 사용자 생성 (JSON - 프로필 없이)
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "신규유저{{$randomInt}}",
+  "email": "user{{$randomInt}}@example.com",
+  "password": "password123"
+}
+
+### 1-5. 사용자 생성 (Multipart - 프로필 포함)
+POST {{baseUrl}}/users/with-profile
+Content-Type: multipart/form-data; boundary=WebAppBoundary
+
+--WebAppBoundary
+Content-Disposition: form-data; name="username"
+
+프로필유저{{$randomInt}}
+--WebAppBoundary
+Content-Disposition: form-data; name="email"
+
+profile{{$randomInt}}@example.com
+--WebAppBoundary
+Content-Disposition: form-data; name="password"
+
+password123
+--WebAppBoundary
+Content-Disposition: form-data; name="profileImage"; filename="test.jpg"
+Content-Type: image/jpeg
+
+< ./src/main/resources/data/profiles/hansj.jpg
+--WebAppBoundary--
+
+### 1-6. 사용자 정보 수정 (JSON)
+PUT {{baseUrl}}/users/{{user1Id}}
+Content-Type: application/json
+
+{
+  "username": "{{user1Name}}_수정됨",
+  "email": "hansj_modified@codeit.com",
+  "password": "newpassword123"
+}
+
+### 1-7. 사용자 정보 수정 (Multipart - 프로필 포함)
+PUT {{baseUrl}}/users/{{user1Id}}/with-profile
+Content-Type: multipart/form-data; boundary=WebAppBoundary
+
+--WebAppBoundary
+Content-Disposition: form-data; name="username"
+
+{{user1Name}}
+--WebAppBoundary
+Content-Disposition: form-data; name="email"
+
+hansj@codeit.com
+--WebAppBoundary
+Content-Disposition: form-data; name="password"
+
+password123
+--WebAppBoundary
+Content-Disposition: form-data; name="profileImage"; filename="updated.jpg"
+Content-Type: image/jpeg
+
+< ./src/main/resources/data/profiles/janghm.jpg
+--WebAppBoundary--
+
+### ==========================================
+### 2. 사용자 상태 관리 API
+### ==========================================
+
+### 2-1. 한성재 온라인 상태 업데이트
+PUT {{baseUrl}}/users/{{user1Id}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+### 2-2. 모든 사용자 온라인 상태 업데이트
+PUT {{baseUrl}}/users/{{user1Id}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+###
+PUT {{baseUrl}}/users/{{user2Id}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+###
+PUT {{baseUrl}}/users/{{user3Id}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+###
+PUT {{baseUrl}}/users/{{user4Id}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+### ==========================================
+### 3. 바이너리 콘텐츠 조회 API
+### ==========================================
+
+### 3-1. 한성재 프로필 이미지 조회
+GET {{baseUrl}}/binary-contents/{{user1ProfileId}}
+Accept: application/json
+
+### 3-2. 장현민 프로필 이미지 조회
+GET {{baseUrl}}/binary-contents/{{user3ProfileId}}
+Accept: application/json
+
+### 3-3. 여러 프로필 이미지 조회 (한성재 + 장현민)
+GET {{baseUrl}}/binary-contents?ids={{user1ProfileId}},{{user3ProfileId}}
+Accept: application/json
+
+### 3-4. 모든 사용자 프로필 이미지 조회
+GET {{baseUrl}}/binary-contents?ids={{user1ProfileId}},{{user2ProfileId}},{{user3ProfileId}},{{user4ProfileId}}
+Accept: application/json
+
+### ==========================================
+### 4. 전체 시나리오 테스트
+### ==========================================
+
+### 시나리오 1: 새 사용자 등록
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "시나리오유저",
+  "email": "scenario_{{$randomInt}}@test.com",
+  "password": "test1234"
+}
+
+> {%
+    client.global.set("newUserId", response.body.id);
+    client.log("✅ 사용자 생성 완료 - ID: " + response.body.id);
+%}
+
+### 시나리오 2: 생성한 사용자 조회
+GET {{baseUrl}}/users/{{newUserId}}
+Accept: application/json
+
+> {%
+    client.test("사용자 조회 성공", function() {
+        client.assert(response.status === 200, "상태 코드가 200이어야 함");
+        client.assert(response.body.id === client.global.get("newUserId"), "ID가 일치해야 함");
+    });
+    client.log("✅ 사용자 조회 완료 - 이름: " + response.body.username);
+%}
+
+### 시나리오 3: 온라인 상태 업데이트
+PUT {{baseUrl}}/users/{{newUserId}}/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$isoTimestamp}}"
+}
+
+> {%
+    client.test("온라인 상태 업데이트 성공", function() {
+        client.assert(response.status === 200, "상태 코드가 200이어야 함");
+        client.assert(response.body.online === true, "온라인 상태여야 함");
+    });
+    client.log("✅ 온라인 상태 업데이트 완료");
+%}
+
+### 시나리오 4: 사용자 정보 수정
+PUT {{baseUrl}}/users/{{newUserId}}
+Content-Type: application/json
+
+{
+  "username": "시나리오유저_수정됨",
+  "email": "scenario_modified@test.com",
+  "password": "newpassword"
+}
+
+> {%
+    client.test("사용자 수정 성공", function() {
+        client.assert(response.status === 200, "상태 코드가 200이어야 함");
+        client.assert(response.body.username === "시나리오유저_수정됨", "이름이 수정되어야 함");
+    });
+    client.log("✅ 사용자 정보 수정 완료");
+%}
+
+### 시나리오 5: 생성한 사용자 삭제
+DELETE {{baseUrl}}/users/{{newUserId}}
+
+> {%
+    client.test("사용자 삭제 성공", function() {
+        client.assert(response.status === 204, "상태 코드가 204여야 함");
+    });
+    client.log("✅ 사용자 삭제 완료");
+%}
+
+### 시나리오 6: 삭제된 사용자 조회 (404 응답 확인)
+GET {{baseUrl}}/users/{{newUserId}}
+Accept: application/json
+
+> {%
+    client.test("삭제된 사용자는 404", function() {
+        client.assert(response.status === 404, "상태 코드가 404여야 함");
+    });
+    client.log("✅ 삭제 확인 완료 - 404 응답");
+%}
+
+### ==========================================
+### 5. 에러 케이스 테스트
+### ==========================================
+
+### 5-1. 중복 이메일로 사용자 생성 (실패)
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "중복테스트",
+  "email": "hansj@codeit.com",
+  "password": "test1234"
+}
+
+> {%
+    client.test("중복 이메일은 실패해야 함", function() {
+        client.assert(response.status === 400 || response.status === 409, "에러 상태 코드여야 함");
+    });
+    client.log("✅ 중복 검증 완료 - 에러 발생");
+%}
+
+### 5-2. 존재하지 않는 사용자 조회 (404)
+GET {{baseUrl}}/users/00000000-0000-0000-0000-000000000000
+Accept: application/json
+
+> {%
+    client.test("존재하지 않는 사용자는 404", function() {
+        client.assert(response.status === 404, "상태 코드가 404여야 함");
+    });
+    client.log("✅ 404 응답 확인 완료");
+%}
+
+### 5-3. 존재하지 않는 바이너리 콘텐츠 조회 (404)
+GET {{baseUrl}}/binary-contents/00000000-0000-0000-0000-000000000000
+Accept: application/json
+
+> {%
+    client.test("존재하지 않는 파일은 404", function() {
+        client.assert(response.status === 404, "상태 코드가 404여야 함");
+    });
+    client.log("✅ 404 응답 확인 완료");
+%}
+
+### ==========================================
+### 6. 성능 테스트 - 여러 사용자 연속 생성
+### ==========================================
+
+### 성능 테스트 1
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트1_{{$timestamp}}",
+  "email": "perf1_{{$timestamp}}@test.com",
+  "password": "test1234"
+}
+
+###
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트2_{{$timestamp}}",
+  "email": "perf2_{{$timestamp}}@test.com",
+  "password": "test1234"
+}
+
+###
+POST {{baseUrl}}/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트3_{{$timestamp}}",
+  "email": "perf3_{{$timestamp}}@test.com",
+  "password": "test1234"
+}
+
+### ==========================================
+### 사용 가능한 동적 변수
+### ==========================================
+# {{$uuid}}          - 랜덤 UUID
+# {{$timestamp}}     - Unix 타임스탬프 (밀리초)
+# {{$isoTimestamp}}  - ISO 8601 형식의 현재 시간
+# {{$randomInt}}     - 0-1000 사이의 랜덤 정수
+# {{$random.uuid}}   - 또 다른 형태의 UUID
diff --git a/discodeit/docs/api-tests.http b/discodeit/docs/api-tests.http
new file mode 100644
index 00000000..ec33b8ec
--- /dev/null
+++ b/discodeit/docs/api-tests.http
@@ -0,0 +1,202 @@
+### Discodeit API 테스트 모음
+### IntelliJ에서 각 요청 옆의 '▶' 버튼을 클릭하거나 Ctrl+Enter (Mac: Cmd+Enter)로 실행
+
+### ==========================================
+### 1. 사용자 관리 API
+### ==========================================
+
+### 1-1. 모든 사용자 조회
+GET http://localhost:8080/users
+Accept: application/json
+
+### 1-2. 특정 사용자 조회 (ID는 실제 값으로 변경)
+GET http://localhost:8080/users/7559dc90-d2de-4de2-a2b3-48a621c61f41
+Accept: application/json
+
+### 1-3. 사용자 생성 (JSON - 프로필 없이)
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "테스트유저1",
+  "email": "test1@example.com",
+  "password": "password123"
+}
+
+### 1-4. 사용자 생성 (Multipart - 프로필 포함)
+POST http://localhost:8080/users/with-profile
+Content-Type: multipart/form-data; boundary=WebAppBoundary
+
+--WebAppBoundary
+Content-Disposition: form-data; name="username"
+
+테스트유저2
+--WebAppBoundary
+Content-Disposition: form-data; name="email"
+
+test2@example.com
+--WebAppBoundary
+Content-Disposition: form-data; name="password"
+
+password123
+--WebAppBoundary
+Content-Disposition: form-data; name="profileImage"; filename="test.jpg"
+Content-Type: image/jpeg
+
+< ./src/main/resources/data/profiles/hansj.jpg
+--WebAppBoundary--
+
+### 1-5. 사용자 정보 수정 (JSON - 프로필 없이)
+PUT http://localhost:8080/users/7559dc90-d2de-4de2-a2b3-48a621c61f41
+Content-Type: application/json
+
+{
+  "username": "한성재_수정",
+  "email": "hansj_updated@codeit.com",
+  "password": "newpassword123"
+}
+
+### 1-6. 사용자 정보 수정 (Multipart - 프로필 포함)
+PUT http://localhost:8080/users/7559dc90-d2de-4de2-a2b3-48a621c61f41/with-profile
+Content-Type: multipart/form-data; boundary=WebAppBoundary
+
+--WebAppBoundary
+Content-Disposition: form-data; name="username"
+
+한성재_최종
+--WebAppBoundary
+Content-Disposition: form-data; name="email"
+
+hansj@codeit.com
+--WebAppBoundary
+Content-Disposition: form-data; name="password"
+
+password123
+--WebAppBoundary
+Content-Disposition: form-data; name="profileImage"; filename="hansj.jpg"
+Content-Type: image/jpeg
+
+< ./src/main/resources/data/profiles/hansj.jpg
+--WebAppBoundary--
+
+### 1-7. 사용자 삭제 (테스트 유저 ID로 변경 필요)
+# DELETE http://localhost:8080/users/테스트유저ID
+
+### ==========================================
+### 2. 사용자 상태 관리 API
+### ==========================================
+
+### 2-1. 온라인 상태 업데이트
+PUT http://localhost:8080/users/7559dc90-d2de-4de2-a2b3-48a621c61f41/status
+Content-Type: application/json
+
+{
+  "lastAccessAt": "{{$timestamp}}"
+}
+
+### ==========================================
+### 3. 바이너리 콘텐츠 조회 API
+### ==========================================
+
+### 3-1. 파일 1개 조회 (프로필 ID로 변경)
+GET http://localhost:8080/binary-contents/9f0ed3d9-5f59-4b3f-95c8-06dc2f9ab8b3
+Accept: application/json
+
+### 3-2. 파일 여러개 조회 (한성재, 장현민 프로필)
+GET http://localhost:8080/binary-contents?ids=9f0ed3d9-5f59-4b3f-95c8-06dc2f9ab8b3,571694c6-e839-4fa0-81ee-a4c3a04290b4
+Accept: application/json
+
+### 3-3. 파일 여러개 조회 (모든 사용자 프로필)
+GET http://localhost:8080/binary-contents?ids=9f0ed3d9-5f59-4b3f-95c8-06dc2f9ab8b3,571694c6-e839-4fa0-81ee-a4c3a04290b4,5b6243b9-0ab5-4fc2-84e7-8497f030f2a0,a0a39374-e9d3-4c59-8840-2f2078f2641a
+Accept: application/json
+
+### ==========================================
+### 4. 전체 시나리오 테스트
+### ==========================================
+
+### 시나리오 1: 새 사용자 등록 후 조회
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "시나리오테스트",
+  "email": "scenario@test.com",
+  "password": "test1234"
+}
+
+> {%
+    client.global.set("newUserId", response.body.id);
+    client.log("Created user ID: " + response.body.id);
+%}
+
+### 시나리오 2: 방금 생성한 사용자 조회
+GET http://localhost:8080/users/{{newUserId}}
+Accept: application/json
+
+### 시나리오 3: 방금 생성한 사용자 삭제
+DELETE http://localhost:8080/users/{{newUserId}}
+
+### ==========================================
+### 5. 성능 테스트 (여러 사용자 생성)
+### ==========================================
+
+### 성능 테스트 1: 사용자 1
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트1",
+  "email": "perf1@test.com",
+  "password": "test1234"
+}
+
+### 성능 테스트 2: 사용자 2
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트2",
+  "email": "perf2@test.com",
+  "password": "test1234"
+}
+
+### 성능 테스트 3: 사용자 3
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "성능테스트3",
+  "email": "perf3@test.com",
+  "password": "test1234"
+}
+
+### ==========================================
+### 6. 에러 케이스 테스트
+### ==========================================
+
+### 6-1. 중복 이메일로 사용자 생성 (실패해야 함)
+POST http://localhost:8080/users
+Content-Type: application/json
+
+{
+  "username": "중복테스트",
+  "email": "hansj@codeit.com",
+  "password": "test1234"
+}
+
+### 6-2. 존재하지 않는 사용자 조회 (404 응답)
+GET http://localhost:8080/users/00000000-0000-0000-0000-000000000000
+Accept: application/json
+
+### 6-3. 존재하지 않는 바이너리 콘텐츠 조회 (404 응답)
+GET http://localhost:8080/binary-contents/00000000-0000-0000-0000-000000000000
+Accept: application/json
+
+### ==========================================
+### 참고: 환경 변수 사용
+### ==========================================
+# IntelliJ HTTP Client는 다음과 같은 변수를 지원합니다:
+# - {{$timestamp}}: 현재 타임스탬프 (ISO 8601)
+# - {{$randomInt}}: 랜덤 정수
+# - {{$uuid}}: 랜덤 UUID
+# - 커스텀 변수: client.global.set() 사용
diff --git a/discodeit/docs/http-client.env.json b/discodeit/docs/http-client.env.json
new file mode 100644
index 00000000..ee5720dd
--- /dev/null
+++ b/discodeit/docs/http-client.env.json
@@ -0,0 +1,17 @@
+{
+  "dev": {
+    "baseUrl": "http://localhost:8080",
+    "user1Id": "10000000-0000-0000-0000-000000000001",
+    "user1Name": "한성재",
+    "user1ProfileId": "10000000-0000-0000-0000-000000000002",
+    "user2Id": "20000000-0000-0000-0000-000000000001",
+    "user2Name": "장현민",
+    "user2ProfileId": "20000000-0000-0000-0000-000000000002",
+    "user3Id": "30000000-0000-0000-0000-000000000001",
+    "user3Name": "전명훈",
+    "user3ProfileId": "30000000-0000-0000-0000-000000000002",
+    "user4Id": "40000000-0000-0000-0000-000000000001",
+    "user4Name": "서현하",
+    "user4ProfileId": "40000000-0000-0000-0000-000000000002"
+  }
+}
diff --git "a/discodeit/docs/\352\271\200\354\262\240\354\210\230 \355\224\204\353\241\234\355\225\204.png" "b/discodeit/docs/\352\271\200\354\262\240\354\210\230 \355\224\204\353\241\234\355\225\204.png"
new file mode 100644
index 00000000..5c496f25
Binary files /dev/null and "b/discodeit/docs/\352\271\200\354\262\240\354\210\230 \355\224\204\353\241\234\355\225\204.png" differ
diff --git "a/discodeit/docs/\353\260\225\353\257\274\354\210\230 \355\224\204\353\241\234\355\225\204.png" "b/discodeit/docs/\353\260\225\353\257\274\354\210\230 \355\224\204\353\241\234\355\225\204.png"
new file mode 100644
index 00000000..0dd39241
Binary files /dev/null and "b/discodeit/docs/\353\260\225\353\257\274\354\210\230 \355\224\204\353\241\234\355\225\204.png" differ
diff --git "a/discodeit/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\355\233\204 10.49.45.png" "b/discodeit/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\355\233\204 10.49.45.png"
new file mode 100644
index 00000000..d1a6a8d2
Binary files /dev/null and "b/discodeit/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\355\233\204 10.49.45.png" differ
diff --git "a/discodeit/docs/\354\235\264\354\230\201\355\235\254 \355\224\204\353\241\234\355\225\204.png" "b/discodeit/docs/\354\235\264\354\230\201\355\235\254 \355\224\204\353\241\234\355\225\204.png"
new file mode 100644
index 00000000..1e6a05d9
Binary files /dev/null and "b/discodeit/docs/\354\235\264\354\230\201\355\235\254 \355\224\204\353\241\234\355\225\204.png" differ
diff --git "a/discodeit/docs/\354\265\234\354\247\200\354\227\260 \355\224\204\353\241\234\355\225\204.png" "b/discodeit/docs/\354\265\234\354\247\200\354\227\260 \355\224\204\353\241\234\355\225\204.png"
new file mode 100644
index 00000000..f7993c7c
Binary files /dev/null and "b/discodeit/docs/\354\265\234\354\247\200\354\227\260 \355\224\204\353\241\234\355\225\204.png" differ
diff --git a/discodeit/requirements.txt b/discodeit/requirements.txt
new file mode 100644
index 00000000..2c24336e
--- /dev/null
+++ b/discodeit/requirements.txt
@@ -0,0 +1 @@
+requests==2.31.0
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/Discodeit API.postman_test_run.json b/discodeit/src/main/java/com/sprint/mission/discodeit/Discodeit API.postman_test_run.json
new file mode 100644
index 00000000..beb22f0e
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/Discodeit API.postman_test_run.json	
@@ -0,0 +1,735 @@
+{
+	"id": "72aa7dc4-e6f3-482f-9d9c-1131467aaa6d",
+	"name": "Discodeit API",
+	"timestamp": "2026-02-11T13:40:36.311Z",
+	"collection_id": "52123612-cc7620c4-e129-4558-909c-60cb60c4a7d8",
+	"folder_id": 0,
+	"environment_id": "52123612-b20157c7-1753-4dd5-a79e-ca28791a47c2",
+	"totalPass": 23,
+	"delay": 0,
+	"persist": true,
+	"status": "finished",
+	"startedAt": "2026-02-11T13:40:35.589Z",
+	"totalFail": 0,
+	"results": [
+		{
+			"id": "62f080e5-1d87-4729-b59c-d9c262cc57f6",
+			"name": "사용자 등록",
+			"url": "http://localhost:8080/users",
+			"time": 81,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"사용자 등록 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 등록 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				81
+			],
+			"allTests": [
+				{
+					"사용자 등록 성공": true
+				}
+			]
+		},
+		{
+			"id": "38f02c1b-1da3-4305-8a73-966ecd4f514a",
+			"name": "사용자 정보 수정",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001",
+			"time": 5,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"사용자 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"사용자 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "e223f7ff-58d7-474b-916f-bb9e870340a0",
+			"name": "사용자 삭제",
+			"url": "http://localhost:8080/users/199f91c7-2ba9-41d0-9cd9-6bb94a002f3b",
+			"time": 3,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"사용자 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"사용자 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "05657515-669f-416b-abb6-bcd7a6ffc9b1",
+			"name": "모든 사용자 조회",
+			"url": "http://localhost:8080/users",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"모든 사용자 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"모든 사용자 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"모든 사용자 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "3c0426e3-cad0-45a9-b870-d3542de16393",
+			"name": "사용자 온라인 상태 업데이트 (이영희)",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001/status",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "1fccb8ae-a199-42c2-84b1-2e6e050ac4d5",
+			"name": "사용자 온라인 상태 업데이트 (박민수)",
+			"url": "http://localhost:8080/users/30000000-0000-0000-0000-000000000001/status",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "e4500e3f-52b4-40ab-873a-7f0c488a79ba",
+			"name": "사용자 온라인 상태 업데이트 (최지연)",
+			"url": "http://localhost:8080/users/40000000-0000-0000-0000-000000000001/status",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"온라인 상태 업데이트 성공": true
+			},
+			"testPassFailCounts": {
+				"온라인 상태 업데이트 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"온라인 상태 업데이트 성공": true
+				}
+			]
+		},
+		{
+			"id": "13e2e344-786e-4ec1-bc5f-a73047a93695",
+			"name": "사용자 로그인 (박민수)",
+			"url": "http://localhost:8080/auth/login",
+			"time": 4,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"사용자 로그인 성공": true
+			},
+			"testPassFailCounts": {
+				"사용자 로그인 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"사용자 로그인 성공": true
+				}
+			]
+		},
+		{
+			"id": "67a951f5-93ee-4ea9-967c-e8e29fb4b6ad",
+			"name": "공개 채널 생성",
+			"url": "http://localhost:8080/channels/public",
+			"time": 7,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"공개 채널 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"공개 채널 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				7
+			],
+			"allTests": [
+				{
+					"공개 채널 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "f8543bc4-6878-4e40-84b0-48293ece9e98",
+			"name": "비공개 채널 생성",
+			"url": "http://localhost:8080/channels/private",
+			"time": 6,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"비공개 채널 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"비공개 채널 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"비공개 채널 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "c448ff0b-1c2c-44d6-ac60-a1755ac7b888",
+			"name": "공개 채널 정보 수정",
+			"url": "http://localhost:8080/channels/f16f2249-9b95-4ade-8c9a-dcab427daf29",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"공개 채널 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"공개 채널 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"공개 채널 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "e7cdf82b-b3be-457d-93c9-8b4610e1e4db",
+			"name": "채널 삭제",
+			"url": "http://localhost:8080/channels/3f35e0e6-5a0b-4095-aeaf-ac541b04c38b",
+			"time": 2,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"채널 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"채널 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"채널 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "bd3213a7-5150-4bbe-8b10-177e2b9b15c1",
+			"name": "특정 사용자의 모든 채널 목록 조회",
+			"url": "http://localhost:8080/channels?userId=20000000-0000-0000-0000-000000000001",
+			"time": 4,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"채널 목록 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"채널 목록 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"채널 목록 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "468a25e1-0e84-435d-96da-779eb8e77281",
+			"name": "메시지 보내기",
+			"url": "http://localhost:8080/messages",
+			"time": 5,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"메시지 보내기 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 보내기 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"메시지 보내기 성공": true
+				}
+			]
+		},
+		{
+			"id": "1122053e-946c-44d9-a1bc-5c814f355f0b",
+			"name": "메시지 수정",
+			"url": "http://localhost:8080/messages/bcf42db0-a178-4c67-85b8-b00e6216ea2a",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "1cb94982-c954-4c27-bb93-441313ce2519",
+			"name": "메시지 삭제",
+			"url": "http://localhost:8080/messages/bcf42db0-a178-4c67-85b8-b00e6216ea2a",
+			"time": 3,
+			"responseCode": {
+				"code": 204,
+				"name": "No Content"
+			},
+			"tests": {
+				"메시지 삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "52706e31-cbee-4fdc-9638-44097655653d",
+			"name": "특정 채널의 메시지 목록 조회",
+			"url": "http://localhost:8080/messages?channelId=f16f2249-9b95-4ade-8c9a-dcab427daf29",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 목록 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 목록 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 목록 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "5b4ca621-295c-4261-a9df-9978c4f22062",
+			"name": "특정 채널의 메시지 수신 정보 생성",
+			"url": "http://localhost:8080/read-statuses",
+			"time": 4,
+			"responseCode": {
+				"code": 201,
+				"name": "Created"
+			},
+			"tests": {
+				"메시지 수신 정보 생성 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 생성 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 생성 성공": true
+				}
+			]
+		},
+		{
+			"id": "7ab4d359-041b-4b6e-b686-bebb06a082bd",
+			"name": "특정 채널의 메시지 수신 정보 수정",
+			"url": "http://localhost:8080/read-statuses/4936dd2f-9cca-460c-8bfd-1e0a6b3c84ab",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수신 정보 수정 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 수정 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 수정 성공": true
+				}
+			]
+		},
+		{
+			"id": "182a1d87-c2cc-4d03-9ff1-2cc073749b91",
+			"name": "특정 사용자의 메시지 수신 정보 조회",
+			"url": "http://localhost:8080/read-statuses?userId=20000000-0000-0000-0000-000000000001",
+			"time": 2,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"메시지 수신 정보 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"메시지 수신 정보 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"메시지 수신 정보 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "2ea5804a-177f-4c81-861c-2074010d9e74",
+			"name": "바이너리 파일 1개 조회",
+			"url": "http://localhost:8080/binary-contents/20000000-0000-0000-0000-000000000002",
+			"time": 7,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 1개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 1개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				7
+			],
+			"allTests": [
+				{
+					"파일 1개 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "71b66c5b-c4c6-4fc0-9df8-15780abe0860",
+			"name": "바이너리 파일 여러 개 조회 (2명)",
+			"url": "http://localhost:8080/binary-contents?ids=20000000-0000-0000-0000-000000000002,30000000-0000-0000-0000-000000000002",
+			"time": 3,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 여러 개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 여러 개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				3
+			],
+			"allTests": [
+				{
+					"파일 여러 개 조회 성공": true
+				}
+			]
+		},
+		{
+			"id": "365c8a34-d62f-413d-81e0-46e02a774df0",
+			"name": "바이너리 파일 여러 개 조회 (전체)",
+			"url": "http://localhost:8080/binary-contents?ids=20000000-0000-0000-0000-000000000002,30000000-0000-0000-0000-000000000002,40000000-0000-0000-0000-000000000002",
+			"time": 2,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"파일 여러 개 조회 성공": true
+			},
+			"testPassFailCounts": {
+				"파일 여러 개 조회 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				2
+			],
+			"allTests": [
+				{
+					"파일 여러 개 조회 성공": true
+				}
+			]
+		}
+	],
+	"count": 1,
+	"totalTime": 168,
+	"collection": {
+		"requests": [
+			{
+				"id": "62f080e5-1d87-4729-b59c-d9c262cc57f6",
+				"method": "POST"
+			},
+			{
+				"id": "38f02c1b-1da3-4305-8a73-966ecd4f514a",
+				"method": "PUT"
+			},
+			{
+				"id": "e223f7ff-58d7-474b-916f-bb9e870340a0",
+				"method": "DELETE"
+			},
+			{
+				"id": "05657515-669f-416b-abb6-bcd7a6ffc9b1",
+				"method": "GET"
+			},
+			{
+				"id": "3c0426e3-cad0-45a9-b870-d3542de16393",
+				"method": "PUT"
+			},
+			{
+				"id": "1fccb8ae-a199-42c2-84b1-2e6e050ac4d5",
+				"method": "PUT"
+			},
+			{
+				"id": "e4500e3f-52b4-40ab-873a-7f0c488a79ba",
+				"method": "PUT"
+			},
+			{
+				"id": "13e2e344-786e-4ec1-bc5f-a73047a93695",
+				"method": "POST"
+			},
+			{
+				"id": "67a951f5-93ee-4ea9-967c-e8e29fb4b6ad",
+				"method": "POST"
+			},
+			{
+				"id": "f8543bc4-6878-4e40-84b0-48293ece9e98",
+				"method": "POST"
+			},
+			{
+				"id": "c448ff0b-1c2c-44d6-ac60-a1755ac7b888",
+				"method": "PUT"
+			},
+			{
+				"id": "e7cdf82b-b3be-457d-93c9-8b4610e1e4db",
+				"method": "DELETE"
+			},
+			{
+				"id": "bd3213a7-5150-4bbe-8b10-177e2b9b15c1",
+				"method": "GET"
+			},
+			{
+				"id": "468a25e1-0e84-435d-96da-779eb8e77281",
+				"method": "POST"
+			},
+			{
+				"id": "1122053e-946c-44d9-a1bc-5c814f355f0b",
+				"method": "PUT"
+			},
+			{
+				"id": "1cb94982-c954-4c27-bb93-441313ce2519",
+				"method": "DELETE"
+			},
+			{
+				"id": "52706e31-cbee-4fdc-9638-44097655653d",
+				"method": "GET"
+			},
+			{
+				"id": "5b4ca621-295c-4261-a9df-9978c4f22062",
+				"method": "POST"
+			},
+			{
+				"id": "7ab4d359-041b-4b6e-b686-bebb06a082bd",
+				"method": "PUT"
+			},
+			{
+				"id": "182a1d87-c2cc-4d03-9ff1-2cc073749b91",
+				"method": "GET"
+			},
+			{
+				"id": "2ea5804a-177f-4c81-861c-2074010d9e74",
+				"method": "GET"
+			},
+			{
+				"id": "71b66c5b-c4c6-4fc0-9df8-15780abe0860",
+				"method": "GET"
+			},
+			{
+				"id": "365c8a34-d62f-413d-81e0-46e02a774df0",
+				"method": "GET"
+			}
+		]
+	}
+}
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/DiscodeitApplication.java b/discodeit/src/main/java/com/sprint/mission/discodeit/DiscodeitApplication.java
index 02ef38cb..1b0a91b3 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/DiscodeitApplication.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/DiscodeitApplication.java
@@ -3,219 +3,25 @@
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
-import com.sprint.mission.discodeit.dto.request.*;
-import com.sprint.mission.discodeit.dto.response.ChannelResponse;
-import com.sprint.mission.discodeit.dto.response.MessageResponse;
-import com.sprint.mission.discodeit.dto.response.UserResponse;
-import com.sprint.mission.discodeit.entity.BinaryContent;
-import com.sprint.mission.discodeit.entity.ReadStatus;
-import com.sprint.mission.discodeit.entity.UserStatus;
-import com.sprint.mission.discodeit.service.*;
-import org.springframework.context.ConfigurableApplicationContext;
-
-import java.time.Instant;
-import java.util.List;
-import java.util.NoSuchElementException;
-
+/**
+ * Discodeit 애플리케이션의 메인 클래스
+ *
+ * Discord와 유사한 메시징 플랫폼으로, 다음 기능을 제공합니다:
+ * - 사용자 관리 (회원가입, 로그인, 프로필 이미지)
+ * - 채널 관리 (공개 채널, 비공개 채널)
+ * - 메시지 관리 (메시지 작성, 첨부파일)
+ * - 읽기 상태 추적
+ * - 사용자 온라인 상태 관리
+ */
 @SpringBootApplication
 public class DiscodeitApplication {
 
+	/**
+	 * 애플리케이션 시작점
+	 *
+	 * @param args 명령행 인수
+	 */
 	public static void main(String[] args) {
-		ConfigurableApplicationContext context = SpringApplication.run(DiscodeitApplication.class, args);
-
-		// Spring Context에서 Bean 조회
-		UserService userService = context.getBean(UserService.class);
-		ChannelService channelService = context.getBean(ChannelService.class);
-		MessageService messageService = context.getBean(MessageService.class);
-		AuthService authService = context.getBean(AuthService.class);
-		UserStatusService userStatusService = context.getBean(UserStatusService.class);
-		ReadStatusService readStatusService = context.getBean(ReadStatusService.class);
-		BinaryContentService binaryContentService = context.getBean(BinaryContentService.class);
-
-		System.out.println("\n========== Discodeit 서비스 전체 기능 테스트 ==========\n");
-
-		// ===== 1. User 생성 테스트 (프로필 이미지 포함) =====
-		System.out.println("--- 1. User 생성 테스트 (프로필 이미지 포함) ---");
-		BinaryContentCreateRequest profileImageRequest = new BinaryContentCreateRequest(
-				"profile.png",
-				"image/png",
-				new byte[]{1, 2, 3, 4, 5}
-		);
-		UserCreateRequest userRequest = new UserCreateRequest("woody", "woody@codeit.com", "woody1234");
-		UserResponse user = userService.create(userRequest, profileImageRequest);
-		System.out.println("User 생성: " + user.id());
-		System.out.println("  - username: " + user.username());
-		System.out.println("  - email: " + user.email());
-		System.out.println("  - online: " + user.online());
-
-		// 두 번째 사용자 생성 (프로필 이미지 없이)
-		UserCreateRequest user2Request = new UserCreateRequest("alice", "alice@codeit.com", "alice1234");
-		UserResponse user2 = userService.create(user2Request, null);
-		System.out.println("User2 생성: " + user2.id());
-		System.out.println("  - username: " + user2.username());
-
-		// ===== 2. AuthService 로그인 테스트 =====
-		System.out.println("\n--- 2. AuthService 로그인 테스트 ---");
-		LoginRequest loginRequest = new LoginRequest("woody", "woody1234");
-		UserResponse loggedInUser = authService.login(loginRequest);
-		System.out.println("로그인 성공: " + loggedInUser.username());
-		System.out.println("  - online: " + loggedInUser.online());
-
-		// 잘못된 비밀번호 테스트
-		try {
-			LoginRequest wrongLogin = new LoginRequest("woody", "wrongpassword");
-			authService.login(wrongLogin);
-		} catch (NoSuchElementException e) {
-			System.out.println("잘못된 비밀번호 로그인 실패: " + e.getMessage());
-		}
-
-		// ===== 3. UserStatus 테스트 =====
-		System.out.println("\n--- 3. UserStatus 테스트 ---");
-		UserStatus userStatus = userStatusService.findByUserId(user.id());
-		System.out.println("UserStatus 조회: " + userStatus.getId());
-		System.out.println("  - userId: " + userStatus.getUserId());
-		System.out.println("  - isOnline: " + userStatus.isOnline());
-
-		// UserStatus 업데이트
-		UserStatusUpdateRequest statusUpdateRequest = new UserStatusUpdateRequest(Instant.now());
-		userStatusService.updateByUserId(user.id(), statusUpdateRequest);
-		System.out.println("UserStatus 업데이트 완료 - lastActiveAt 갱신됨");
-
-		// ===== 4. PUBLIC Channel 생성 테스트 =====
-		System.out.println("\n--- 4. PUBLIC Channel 생성 테스트 ---");
-		PublicChannelCreateRequest publicChannelRequest = new PublicChannelCreateRequest("공지", "공지 채널입니다.");
-		ChannelResponse publicChannel = channelService.createPublic(publicChannelRequest);
-		System.out.println("PUBLIC Channel 생성: " + publicChannel.id());
-		System.out.println("  - name: " + publicChannel.name());
-		System.out.println("  - type: " + publicChannel.type());
-
-		// PUBLIC Channel 수정 테스트
-		ChannelUpdateRequest channelUpdateRequest = new ChannelUpdateRequest("공지사항", "공지사항 채널입니다.");
-		ChannelResponse updatedChannel = channelService.update(publicChannel.id(), channelUpdateRequest);
-		System.out.println("PUBLIC Channel 수정: " + updatedChannel.name());
-
-		// ===== 5. PRIVATE Channel 생성 테스트 =====
-		System.out.println("\n--- 5. PRIVATE Channel 생성 테스트 ---");
-		PrivateChannelCreateRequest privateChannelRequest = new PrivateChannelCreateRequest(
-				List.of(user.id(), user2.id())
-		);
-		ChannelResponse privateChannel = channelService.createPrivate(privateChannelRequest);
-		System.out.println("PRIVATE Channel 생성: " + privateChannel.id());
-		System.out.println("  - type: " + privateChannel.type());
-		System.out.println("  - participantIds: " + privateChannel.participantIds());
-
-		// PRIVATE Channel 수정 시도 (실패해야 함)
-		try {
-			channelService.update(privateChannel.id(), channelUpdateRequest);
-			System.out.println("PRIVATE Channel 수정: 실패 - 예외가 발생해야 합니다!");
-		} catch (IllegalArgumentException e) {
-			System.out.println("PRIVATE Channel 수정 차단됨: " + e.getMessage());
-		}
-
-		// ===== 6. ReadStatus 테스트 =====
-		System.out.println("\n--- 6. ReadStatus 테스트 ---");
-		// PRIVATE 채널 생성 시 자동으로 ReadStatus가 생성되어야 함
-		List<ReadStatus> readStatuses = readStatusService.findAllByUserId(user.id());
-		System.out.println("User의 ReadStatus 수: " + readStatuses.size());
-		for (ReadStatus rs : readStatuses) {
-			System.out.println("  - channelId: " + rs.getChannelId() + ", lastReadAt: " + rs.getLastReadAt());
-		}
-
-		// ReadStatus 업데이트
-		if (!readStatuses.isEmpty()) {
-			ReadStatus firstReadStatus = readStatuses.get(0);
-			ReadStatusUpdateRequest rsUpdateRequest = new ReadStatusUpdateRequest(Instant.now());
-			readStatusService.update(firstReadStatus.getId(), rsUpdateRequest);
-			System.out.println("ReadStatus 업데이트 완료 - lastReadAt 갱신됨");
-		}
-
-		// ===== 7. Message 생성 테스트 (첨부파일 포함) =====
-		System.out.println("\n--- 7. Message 생성 테스트 (첨부파일 포함) ---");
-		BinaryContentCreateRequest attachmentRequest = new BinaryContentCreateRequest(
-				"document.pdf",
-				"application/pdf",
-				new byte[]{10, 20, 30, 40, 50}
-		);
-		MessageCreateRequest messageRequest = new MessageCreateRequest(
-				"안녕하세요! 첨부파일입니다.",
-				publicChannel.id(),
-				user.id()
-		);
-		MessageResponse message = messageService.create(messageRequest, List.of(attachmentRequest));
-		System.out.println("Message 생성: " + message.id());
-		System.out.println("  - content: " + message.content());
-		System.out.println("  - channelId: " + message.channelId());
-		System.out.println("  - authorId: " + message.authorId());
-		System.out.println("  - attachmentIds: " + message.attachmentIds());
-
-		// 첨부파일 없는 메시지 생성
-		MessageCreateRequest message2Request = new MessageCreateRequest(
-				"두 번째 메시지입니다.",
-				publicChannel.id(),
-				user.id()
-		);
-		MessageResponse message2 = messageService.create(message2Request, null);
-		System.out.println("Message2 생성 (첨부파일 없음): " + message2.id());
-
-		// ===== 8. Message 수정 테스트 =====
-		System.out.println("\n--- 8. Message 수정 테스트 ---");
-		MessageUpdateRequest messageUpdateRequest = new MessageUpdateRequest("수정된 메시지입니다.");
-		MessageResponse updatedMessage = messageService.update(message2.id(), messageUpdateRequest);
-		System.out.println("Message 수정: " + updatedMessage.content());
-
-		// ===== 9. User 수정 테스트 =====
-		System.out.println("\n--- 9. User 수정 테스트 ---");
-		BinaryContentCreateRequest newProfileRequest = new BinaryContentCreateRequest(
-				"new_profile.jpg",
-				"image/jpeg",
-				new byte[]{100, 101, 102}
-		);
-		UserUpdateRequest userUpdateRequest = new UserUpdateRequest("woody_updated", "woody_new@codeit.com", "newpassword");
-		UserResponse updatedUser = userService.update(user.id(), userUpdateRequest, newProfileRequest);
-		System.out.println("User 수정: " + updatedUser.username());
-		System.out.println("  - email: " + updatedUser.email());
-
-		// ===== 10. BinaryContent 조회 테스트 =====
-		System.out.println("\n--- 10. BinaryContent 조회 테스트 ---");
-		if (!message.attachmentIds().isEmpty()) {
-			BinaryContent attachment = binaryContentService.find(message.attachmentIds().get(0));
-			System.out.println("첨부파일 조회: " + attachment.getId());
-			System.out.println("  - fileName: " + attachment.getFileName());
-			System.out.println("  - contentType: " + attachment.getContentType());
-			System.out.println("  - size: " + attachment.getData().length + " bytes");
-		}
-
-		// ===== 11. 조회 테스트 =====
-		System.out.println("\n--- 11. 전체 조회 테스트 ---");
-		List<UserResponse> users = userService.findAll();
-		System.out.println("전체 User 수: " + users.size());
-
-		List<ChannelResponse> channels = channelService.findAllByUserId(user.id());
-		System.out.println("User가 볼 수 있는 Channel 수: " + channels.size());
-
-		List<MessageResponse> messages = messageService.findAllByChannelId(publicChannel.id());
-		System.out.println("Channel의 Message 수: " + messages.size());
-
-		// ===== 12. 삭제 테스트 (Cascading) =====
-		System.out.println("\n--- 12. 삭제 테스트 (Cascading) ---");
-
-		// Message 삭제 (첨부파일도 함께 삭제)
-		System.out.println("Message 삭제 전 - Message 수: " + messageService.findAllByChannelId(publicChannel.id()).size());
-		messageService.delete(message.id());
-		System.out.println("Message 삭제 후 - Message 수: " + messageService.findAllByChannelId(publicChannel.id()).size());
-
-		// Channel 삭제 (관련 Message, ReadStatus 함께 삭제)
-		System.out.println("\nPRIVATE Channel 삭제 테스트");
-		channelService.delete(privateChannel.id());
-		System.out.println("PRIVATE Channel 삭제 완료");
-
-		// User 삭제 테스트 (관련 UserStatus, BinaryContent 함께 삭제)
-		System.out.println("\nUser2 삭제 테스트");
-		userService.delete(user2.id());
-		System.out.println("User2 삭제 완료");
-		List<UserResponse> remainingUsers = userService.findAll();
-		System.out.println("남은 User 수: " + remainingUsers.size());
-
-		System.out.println("\n========== 전체 기능 테스트 완료 ==========\n");
+		SpringApplication.run(DiscodeitApplication.class, args);
 	}
 }
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/config/DataInitializer.java b/discodeit/src/main/java/com/sprint/mission/discodeit/config/DataInitializer.java
new file mode 100644
index 00000000..28cd6ce4
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/config/DataInitializer.java
@@ -0,0 +1,224 @@
+package com.sprint.mission.discodeit.config;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.sprint.mission.discodeit.entity.BinaryContent;
+import com.sprint.mission.discodeit.entity.User;
+import com.sprint.mission.discodeit.entity.UserStatus;
+import com.sprint.mission.discodeit.repository.BinaryContentRepository;
+import com.sprint.mission.discodeit.repository.UserRepository;
+import com.sprint.mission.discodeit.repository.UserStatusRepository;
+
+import java.awt.*;
+import java.awt.image.BufferedImage;
+import java.io.ByteArrayOutputStream;
+import java.time.Instant;
+import java.util.UUID;
+import javax.imageio.ImageIO;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.boot.CommandLineRunner;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Component;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.List;
+import java.util.Random;
+
+/**
+ * 애플리케이션 시작 시 초기 데이터를 로드하는 클래스
+ */
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class DataInitializer implements CommandLineRunner {
+
+    private final UserRepository userRepository;
+    private final BinaryContentRepository binaryContentRepository;
+    private final UserStatusRepository userStatusRepository;
+    private final ObjectMapper objectMapper;
+
+    @Override
+    public void run(String... args) throws Exception {
+        log.info("=== 초기 데이터 로드 시작 ===");
+
+        // 강제 초기화 모드 확인 (--force-init 인자)
+        boolean forceInit = args.length > 0 && args[0].equals("--force-init");
+
+        List<User> existingUsers = userRepository.findAll();
+
+        if (forceInit && !existingUsers.isEmpty()) {
+            log.info("강제 초기화 모드: 기존 사용자 {} 명 삭제 후 재생성", existingUsers.size());
+            existingUsers.forEach(user -> {
+                userRepository.deleteById(user.getId());
+                userStatusRepository.deleteByUserId(user.getId());
+                if (user.getProfileId() != null) {
+                    binaryContentRepository.deleteById(user.getProfileId());
+                }
+            });
+        } else if (!existingUsers.isEmpty()) {
+            log.info("기존 사용자 {} 명이 존재하여 초기 데이터 로드를 건너뜁니다.", existingUsers.size());
+            log.info("모든 데이터를 초기화하려면 애플리케이션을 --force-init 옵션과 함께 실행하세요.");
+            return;
+        }
+
+        loadInitialUsers();
+        log.info("=== 초기 데이터 로드 완료 ===");
+    }
+
+    /**
+     * users.json 파일에서 초기 사용자 데이터를 로드합니다.
+     */
+    private void loadInitialUsers() {
+        try {
+            // users.json 파일 읽기
+            ClassPathResource resource = new ClassPathResource("data/users.json");
+            List<InitialUser> initialUsers = objectMapper.readValue(
+                    resource.getInputStream(),
+                    objectMapper.getTypeFactory().constructCollectionType(List.class, InitialUser.class)
+            );
+
+            // 각 사용자 생성
+            for (InitialUser initialUser : initialUsers) {
+                createUser(initialUser);
+            }
+
+            log.info("총 {}명의 사용자가 생성되었습니다.", initialUsers.size());
+
+        } catch (IOException e) {
+            log.error("초기 사용자 데이터 로드 실패", e);
+        }
+    }
+
+    /**
+     * 사용자와 프로필 이미지를 생성합니다 (고정 UUID 사용).
+     */
+    private void createUser(InitialUser initialUser) {
+        try {
+            // 1. 프로필 이미지 생성 (고정 UUID 사용)
+            UUID profileId = null;
+            if (initialUser.profileImage() != null && initialUser.profileId() != null) {
+                byte[] imageData = loadProfileImageData(initialUser.profileImage(), initialUser.username());
+                if (imageData != null) {
+                    String contentType = getContentType(initialUser.profileImage());
+                    BinaryContent profile = new BinaryContent(
+                            initialUser.profileId(),
+                            initialUser.profileImage(),
+                            contentType,
+                            imageData
+                    );
+                    binaryContentRepository.save(profile);
+                    profileId = initialUser.profileId();
+                }
+            }
+
+            // 2. 사용자 생성 (고정 UUID 사용)
+            User user = new User(
+                    initialUser.id(),
+                    initialUser.username(),
+                    initialUser.email(),
+                    initialUser.password(),
+                    profileId
+            );
+            userRepository.save(user);
+
+            // 3. 사용자 상태 생성 (온라인 상태로 설정)
+            UserStatus userStatus = new UserStatus(initialUser.id(), Instant.now());
+            userStatusRepository.save(userStatus);
+
+            log.info("사용자 생성 완료: {} ({})", initialUser.username(), initialUser.email());
+
+        } catch (Exception e) {
+            log.error("사용자 생성 실패: {} - {}", initialUser.username(), e.getMessage());
+        }
+    }
+
+    /**
+     * 프로필 이미지 파일 데이터를 로드합니다.
+     * 파일이 없으면 자동으로 랜덤 아바타 이미지를 생성합니다.
+     */
+    private byte[] loadProfileImageData(String filename, String username) {
+        try {
+            ClassPathResource imageResource = new ClassPathResource("data/profiles/" + filename);
+            return Files.readAllBytes(imageResource.getFile().toPath());
+        } catch (IOException e) {
+            log.warn("프로필 이미지 파일 없음 ({}), {} 아바타 생성", filename, username);
+            return generateRandomAvatar(username);
+        }
+    }
+
+    /**
+     * 랜덤 아바타 이미지를 생성합니다.
+     */
+    private byte[] generateRandomAvatar(String username) {
+        try {
+            Random random = new Random(username.hashCode());
+            int size = 200;
+            BufferedImage image = new BufferedImage(size, size, BufferedImage.TYPE_INT_RGB);
+            Graphics2D g2d = image.createGraphics();
+
+            // 안티앨리어싱 적용
+            g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
+            g2d.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON);
+
+            // 사용자별 고정된 배경색 (파스텔톤)
+            Color[] pastelColors = {
+                new Color(255, 179, 186), // 연한 분홍
+                new Color(255, 223, 186), // 연한 주황
+                new Color(255, 255, 186), // 연한 노랑
+                new Color(186, 255, 201), // 연한 초록
+                new Color(186, 225, 255), // 연한 파랑
+                new Color(220, 198, 224), // 연한 보라
+            };
+            Color bgColor = pastelColors[Math.abs(username.hashCode()) % pastelColors.length];
+            g2d.setColor(bgColor);
+            g2d.fillRect(0, 0, size, size);
+
+            // 이니셜 텍스트 (사용자 이름의 첫 글자)
+            g2d.setColor(Color.WHITE);
+            // 한글 폰트 지원
+            g2d.setFont(new Font("맑은 고딕", Font.BOLD, 80));
+            FontMetrics fm = g2d.getFontMetrics();
+            String initial = username.substring(0, 1);
+            int x = (size - fm.stringWidth(initial)) / 2;
+            int y = ((size - fm.getHeight()) / 2) + fm.getAscent();
+            g2d.drawString(initial, x, y);
+
+            g2d.dispose();
+
+            // PNG로 변환
+            ByteArrayOutputStream baos = new ByteArrayOutputStream();
+            ImageIO.write(image, "png", baos);
+            return baos.toByteArray();
+
+        } catch (Exception e) {
+            log.error("랜덤 아바타 생성 실패: {}", username, e);
+            return new byte[0];
+        }
+    }
+
+    /**
+     * 파일 확장자로 Content-Type을 결정합니다.
+     */
+    private String getContentType(String filename) {
+        if (filename.endsWith(".png")) {
+            return "image/png";
+        } else if (filename.endsWith(".gif")) {
+            return "image/gif";
+        }
+        return "image/jpeg";
+    }
+
+    /**
+     * 초기 사용자 데이터 DTO
+     */
+    private record InitialUser(
+            UUID id,
+            String username,
+            String email,
+            String password,
+            String profileImage,
+            UUID profileId
+    ) {
+    }
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/AuthController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/AuthController.java
new file mode 100644
index 00000000..c9e3a837
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/AuthController.java
@@ -0,0 +1,39 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.dto.request.LoginRequest;
+import com.sprint.mission.discodeit.dto.response.UserResponse;
+import com.sprint.mission.discodeit.service.AuthService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * 인증 관련 REST API 컨트롤러
+ *
+ * 사용자 로그인 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/auth")
+@RequiredArgsConstructor
+public class AuthController {
+
+	private final AuthService authService;
+
+	/**
+	 * 로그인
+	 * POST /auth/login
+	 */
+	@RequestMapping(
+			method = RequestMethod.POST,
+			path = "login",
+			consumes = {MediaType.APPLICATION_JSON_VALUE}
+	)
+	public ResponseEntity<UserResponse> login(@RequestBody LoginRequest request) {
+		UserResponse user = authService.login(request);
+		return ResponseEntity.ok(user);
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/BinaryContentController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/BinaryContentController.java
new file mode 100644
index 00000000..80a846f4
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/BinaryContentController.java
@@ -0,0 +1,48 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.entity.BinaryContent;
+import com.sprint.mission.discodeit.service.BinaryContentService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 바이너리 콘텐츠 관련 REST API 컨트롤러
+ *
+ * 파일(프로필 이미지, 첨부파일 등) 조회 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/binary-contents")
+@RequiredArgsConstructor
+public class BinaryContentController {
+
+	private final BinaryContentService binaryContentService;
+
+	/**
+	 * 바이너리 파일 1개 조회
+	 * GET /binary-contents/{id}
+	 */
+	@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+	public ResponseEntity<BinaryContent> getBinaryContent(@PathVariable UUID id) {
+		BinaryContent binaryContent = binaryContentService.find(id);
+		return ResponseEntity.ok(binaryContent);
+	}
+
+	/**
+	 * 여러 바이너리 파일 조회
+	 * GET /binary-contents?ids={id1},{id2},...
+	 */
+	@RequestMapping(method = RequestMethod.GET)
+	public ResponseEntity<List<BinaryContent>> getBinaryContents(@RequestParam List<UUID> ids) {
+		List<BinaryContent> binaryContents = binaryContentService.findAllByIdIn(ids);
+		return ResponseEntity.ok(binaryContents);
+	}
+
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ChannelController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ChannelController.java
new file mode 100644
index 00000000..88e874f8
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ChannelController.java
@@ -0,0 +1,95 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.dto.request.ChannelUpdateRequest;
+import com.sprint.mission.discodeit.dto.request.PrivateChannelCreateRequest;
+import com.sprint.mission.discodeit.dto.request.PublicChannelCreateRequest;
+import com.sprint.mission.discodeit.dto.response.ChannelResponse;
+import com.sprint.mission.discodeit.service.ChannelService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 채널 관련 REST API 컨트롤러
+ *
+ * 공개/비공개 채널 생성, 조회, 수정, 삭제 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/channels")
+@RequiredArgsConstructor
+public class ChannelController {
+
+	private final ChannelService channelService;
+
+	/**
+	 * 공개 채널 생성
+	 * POST /channels/public
+	 */
+	@RequestMapping(method = RequestMethod.POST, value = "/public")
+	public ResponseEntity<ChannelResponse> createPublicChannel(@RequestBody PublicChannelCreateRequest request) {
+		ChannelResponse channel = channelService.createPublic(request);
+		return ResponseEntity.status(HttpStatus.CREATED).body(channel);
+	}
+
+	/**
+	 * 비공개 채널 생성
+	 * POST /channels/private
+	 */
+	@RequestMapping(method = RequestMethod.POST, value = "/private")
+	public ResponseEntity<ChannelResponse> createPrivateChannel(@RequestBody PrivateChannelCreateRequest request) {
+		ChannelResponse channel = channelService.createPrivate(request);
+		return ResponseEntity.status(HttpStatus.CREATED).body(channel);
+	}
+
+	/**
+	 * 특정 사용자가 볼 수 있는 모든 채널 조회
+	 * GET /channels?userId={userId}
+	 */
+	@RequestMapping(method = RequestMethod.GET)
+	public ResponseEntity<List<ChannelResponse>> getChannelsByUser(@RequestParam UUID userId) {
+		List<ChannelResponse> channels = channelService.findAllByUserId(userId);
+		return ResponseEntity.ok(channels);
+	}
+
+	/**
+	 * 특정 채널 조회
+	 * GET /channels/{id}
+	 */
+	@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+	public ResponseEntity<ChannelResponse> getChannel(@PathVariable UUID id) {
+		ChannelResponse channel = channelService.find(id);
+		return ResponseEntity.ok(channel);
+	}
+
+	/**
+	 * 공개 채널 정보 수정
+	 * PUT /channels/{id}
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}")
+	public ResponseEntity<ChannelResponse> updateChannel(
+			@PathVariable UUID id,
+			@RequestBody ChannelUpdateRequest request
+	) {
+		ChannelResponse channel = channelService.update(id, request);
+		return ResponseEntity.ok(channel);
+	}
+
+	/**
+	 * 채널 삭제
+	 * DELETE /channels/{id}
+	 */
+	@RequestMapping(method = RequestMethod.DELETE, value = "/{id}")
+	public ResponseEntity<Void> deleteChannel(@PathVariable UUID id) {
+		channelService.delete(id);
+		return ResponseEntity.noContent().build();
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/MessageController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/MessageController.java
new file mode 100644
index 00000000..0715d71b
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/MessageController.java
@@ -0,0 +1,88 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.dto.request.BinaryContentCreateRequest;
+import com.sprint.mission.discodeit.dto.request.MessageCreateRequest;
+import com.sprint.mission.discodeit.dto.request.MessageUpdateRequest;
+import com.sprint.mission.discodeit.dto.response.MessageResponse;
+import com.sprint.mission.discodeit.service.MessageService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 메시지 관련 REST API 컨트롤러
+ *
+ * 메시지 전송, 조회, 수정, 삭제 및 첨부파일 관리 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/messages")
+@RequiredArgsConstructor
+public class MessageController {
+
+	private final MessageService messageService;
+
+	/**
+	 * 메시지 전송
+	 * POST /messages
+	 */
+	@RequestMapping(method = RequestMethod.POST)
+	public ResponseEntity<MessageResponse> createMessage(
+			@RequestBody MessageCreateRequest messageRequest
+	) {
+		// 첨부파일은 null로 전달 (별도 엔드포인트로 업로드 가능)
+		MessageResponse message = messageService.create(messageRequest, null);
+		return ResponseEntity.status(HttpStatus.CREATED).body(message);
+	}
+
+	/**
+	 * 특정 채널의 메시지 목록 조회
+	 * GET /messages?channelId={channelId}
+	 */
+	@RequestMapping(method = RequestMethod.GET)
+	public ResponseEntity<List<MessageResponse>> getMessagesByChannel(@RequestParam UUID channelId) {
+		List<MessageResponse> messages = messageService.findAllByChannelId(channelId);
+		return ResponseEntity.ok(messages);
+	}
+
+	/**
+	 * 특정 메시지 조회
+	 * GET /messages/{id}
+	 */
+	@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+	public ResponseEntity<MessageResponse> getMessage(@PathVariable UUID id) {
+		MessageResponse message = messageService.find(id);
+		return ResponseEntity.ok(message);
+	}
+
+	/**
+	 * 메시지 수정
+	 * PUT /messages/{id}
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}")
+	public ResponseEntity<MessageResponse> updateMessage(
+			@PathVariable UUID id,
+			@RequestBody MessageUpdateRequest request
+	) {
+		MessageResponse message = messageService.update(id, request);
+		return ResponseEntity.ok(message);
+	}
+
+	/**
+	 * 메시지 삭제
+	 * DELETE /messages/{id}
+	 */
+	@RequestMapping(method = RequestMethod.DELETE, value = "/{id}")
+	public ResponseEntity<Void> deleteMessage(@PathVariable UUID id) {
+		messageService.delete(id);
+		return ResponseEntity.noContent().build();
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ReadStatusController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ReadStatusController.java
new file mode 100644
index 00000000..13f82315
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/ReadStatusController.java
@@ -0,0 +1,64 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.dto.request.ReadStatusCreateRequest;
+import com.sprint.mission.discodeit.dto.request.ReadStatusUpdateRequest;
+import com.sprint.mission.discodeit.entity.ReadStatus;
+import com.sprint.mission.discodeit.service.ReadStatusService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 읽기 상태 관련 REST API 컨트롤러
+ *
+ * 사용자의 채널별 메시지 읽기 상태를 관리하는 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/read-statuses")
+@RequiredArgsConstructor
+public class ReadStatusController {
+
+	private final ReadStatusService readStatusService;
+
+	/**
+	 * 메시지 수신 정보 생성
+	 * POST /read-statuses
+	 */
+	@RequestMapping(method = RequestMethod.POST)
+	public ResponseEntity<ReadStatus> createReadStatus(@RequestBody ReadStatusCreateRequest request) {
+		ReadStatus readStatus = readStatusService.create(request);
+		return ResponseEntity.status(HttpStatus.CREATED).body(readStatus);
+	}
+
+	/**
+	 * 특정 사용자의 메시지 수신 정보 조회
+	 * GET /read-statuses?userId={userId}
+	 */
+	@RequestMapping(method = RequestMethod.GET)
+	public ResponseEntity<List<ReadStatus>> getReadStatusesByUser(@RequestParam UUID userId) {
+		List<ReadStatus> readStatuses = readStatusService.findAllByUserId(userId);
+		return ResponseEntity.ok(readStatuses);
+	}
+
+	/**
+	 * 메시지 수신 정보 수정
+	 * PUT /read-statuses/{id}
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}")
+	public ResponseEntity<ReadStatus> updateReadStatus(
+			@PathVariable UUID id,
+			@RequestBody ReadStatusUpdateRequest request
+	) {
+		ReadStatus readStatus = readStatusService.update(id, request);
+		return ResponseEntity.ok(readStatus);
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/controller/UserController.java b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/UserController.java
new file mode 100644
index 00000000..c9b2ca57
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/controller/UserController.java
@@ -0,0 +1,183 @@
+package com.sprint.mission.discodeit.controller;
+
+import com.sprint.mission.discodeit.dto.request.BinaryContentCreateRequest;
+import com.sprint.mission.discodeit.dto.request.UserCreateRequest;
+import com.sprint.mission.discodeit.dto.request.UserStatusUpdateRequest;
+import com.sprint.mission.discodeit.dto.request.UserUpdateRequest;
+import com.sprint.mission.discodeit.dto.response.UserDto;
+import com.sprint.mission.discodeit.dto.response.UserResponse;
+import com.sprint.mission.discodeit.entity.UserStatus;
+import com.sprint.mission.discodeit.service.UserService;
+import com.sprint.mission.discodeit.service.UserStatusService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 사용자 관련 REST API 컨트롤러
+ *
+ * 사용자 생성, 조회, 수정, 삭제 및 온라인 상태 관리 기능을 제공합니다.
+ */
+@RestController
+@RequestMapping("/users")
+@RequiredArgsConstructor
+public class UserController {
+
+	private final UserService userService;
+	private final UserStatusService userStatusService;
+
+	/**
+	 * 사용자 등록 (JSON)
+	 * POST /users
+	 * Content-Type: application/json
+	 */
+	@RequestMapping(method = RequestMethod.POST, consumes = "application/json")
+	public ResponseEntity<UserResponse> createUser(
+			@RequestBody UserCreateRequest userRequest
+	) {
+		// 프로필 이미지는 null로 전달
+		UserResponse user = userService.create(userRequest, null);
+		return ResponseEntity.status(HttpStatus.CREATED).body(user);
+	}
+
+	/**
+	 * 사용자 등록 (프로필 이미지 포함)
+	 * POST /users/with-profile
+	 * Content-Type: multipart/form-data
+	 */
+	@RequestMapping(method = RequestMethod.POST, value = "/with-profile", consumes = "multipart/form-data")
+	public ResponseEntity<UserResponse> createUserWithProfile(
+			@RequestParam("username") String username,
+			@RequestParam("email") String email,
+			@RequestParam("password") String password,
+			@RequestParam(value = "profileImage", required = false) MultipartFile profileImage
+	) {
+		try {
+			// 사용자 생성 요청 객체 생성
+			UserCreateRequest userRequest = new UserCreateRequest(username, email, password);
+
+			// 프로필 이미지가 있으면 BinaryContentCreateRequest로 변환
+			BinaryContentCreateRequest profileRequest = null;
+			if (profileImage != null && !profileImage.isEmpty()) {
+				profileRequest = new BinaryContentCreateRequest(
+						profileImage.getOriginalFilename(),
+						profileImage.getContentType(),
+						profileImage.getBytes()
+				);
+			}
+
+			// 사용자 생성
+			UserResponse user = userService.create(userRequest, profileRequest);
+			return ResponseEntity.status(HttpStatus.CREATED).body(user);
+
+		} catch (Exception e) {
+			throw new RuntimeException("프로필 이미지 업로드 실패: " + e.getMessage(), e);
+		}
+	}
+
+	/**
+	 * 모든 사용자 조회
+	 * GET /users
+	 * 사용자 목록을 UserDto 형식으로 반환합니다.
+	 */
+	@RequestMapping(method = RequestMethod.GET)
+	public ResponseEntity<List<UserDto>> getAllUsers() {
+		List<UserDto> users = userService.findAllAsDto();
+		return ResponseEntity.ok(users);
+	}
+
+	/**
+	 * 특정 사용자 조회
+	 * GET /users/{id}
+	 */
+	@RequestMapping(method = RequestMethod.GET, value = "/{id}")
+	public ResponseEntity<UserResponse> getUser(@PathVariable UUID id) {
+		UserResponse user = userService.find(id);
+		return ResponseEntity.ok(user);
+	}
+
+	/**
+	 * 사용자 정보 수정 (JSON)
+	 * PUT /users/{id}
+	 * Content-Type: application/json
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}", consumes = "application/json")
+	public ResponseEntity<UserResponse> updateUser(
+			@PathVariable UUID id,
+			@RequestBody UserUpdateRequest userRequest
+	) {
+		// 프로필 이미지는 null로 전달
+		UserResponse user = userService.update(id, userRequest, null);
+		return ResponseEntity.ok(user);
+	}
+
+	/**
+	 * 사용자 정보 수정 (프로필 이미지 포함)
+	 * PUT /users/{id}/with-profile
+	 * Content-Type: multipart/form-data
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}/with-profile", consumes = "multipart/form-data")
+	public ResponseEntity<UserResponse> updateUserWithProfile(
+			@PathVariable UUID id,
+			@RequestParam("username") String username,
+			@RequestParam("email") String email,
+			@RequestParam("password") String password,
+			@RequestParam(value = "profileImage", required = false) MultipartFile profileImage
+	) {
+		try {
+			// 사용자 수정 요청 객체 생성
+			UserUpdateRequest userRequest = new UserUpdateRequest(username, email, password);
+
+			// 프로필 이미지가 있으면 BinaryContentCreateRequest로 변환
+			BinaryContentCreateRequest profileRequest = null;
+			if (profileImage != null && !profileImage.isEmpty()) {
+				profileRequest = new BinaryContentCreateRequest(
+						profileImage.getOriginalFilename(),
+						profileImage.getContentType(),
+						profileImage.getBytes()
+				);
+			}
+
+			// 사용자 정보 수정
+			UserResponse user = userService.update(id, userRequest, profileRequest);
+			return ResponseEntity.ok(user);
+
+		} catch (Exception e) {
+			throw new RuntimeException("프로필 이미지 업로드 실패: " + e.getMessage(), e);
+		}
+	}
+
+	/**
+	 * 사용자 삭제
+	 * DELETE /users/{id}
+	 */
+	@RequestMapping(method = RequestMethod.DELETE, value = "/{id}")
+	public ResponseEntity<Void> deleteUser(@PathVariable UUID id) {
+		userService.delete(id);
+		return ResponseEntity.noContent().build();
+	}
+
+	/**
+	 * 온라인 상태 업데이트
+	 * PUT /users/{id}/status
+	 */
+	@RequestMapping(method = RequestMethod.PUT, value = "/{id}/status")
+	public ResponseEntity<UserStatus> updateUserStatus(
+			@PathVariable UUID id,
+			@RequestBody UserStatusUpdateRequest request
+	) {
+		UserStatus userStatus = userStatusService.updateByUserId(id, request);
+		return ResponseEntity.ok(userStatus);
+	}
+
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/docs/API_DOCUMENTATION.md b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/API_DOCUMENTATION.md
new file mode 100644
index 00000000..a1dc3328
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/API_DOCUMENTATION.md
@@ -0,0 +1,808 @@
+# 디스코드잇 API 문서
+
+디스코드잇 웹 API의 전체 엔드포인트와 사용 방법을 설명합니다.
+
+**Base URL:** `http://localhost:8080`
+
+**Content-Type:** `application/json`
+
+---
+
+## 📑 목차
+
+1. [사용자 관리](#1-사용자-관리)
+2. [권한 관리](#2-권한-관리)
+3. [채널 관리](#3-채널-관리)
+4. [메시지 관리](#4-메시지-관리)
+5. [메시지 수신 정보 관리](#5-메시지-수신-정보-관리)
+6. [바이너리 파일 관리](#6-바이너리-파일-관리)
+
+---
+
+## 1. 사용자 관리
+
+### 1.1 사용자 등록
+
+사용자를 새로 등록합니다.
+
+```http
+POST /users
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "username": "testuser",
+  "email": "test@example.com",
+  "password": "password123"
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "id": "uuid",
+  "username": "testuser",
+  "email": "test@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 1.2 전체 사용자 조회
+
+모든 사용자를 조회합니다.
+
+```http
+GET /users
+```
+
+**Response (200 OK):**
+```json
+[
+  {
+    "id": "uuid",
+    "username": "testuser",
+    "email": "test@example.com",
+    "profileId": null,
+    "isOnline": true,
+    "createdAt": "2026-02-09T08:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  }
+]
+```
+
+---
+
+### 1.3 특정 사용자 조회
+
+특정 사용자의 정보를 조회합니다.
+
+```http
+GET /users/{userId}
+```
+
+**Path Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "username": "testuser",
+  "email": "test@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+**Error (404 Not Found):**
+```json
+{
+  "message": "User not found: {userId}",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 1.4 사용자 정보 수정
+
+사용자 정보를 수정합니다.
+
+```http
+PUT /users/{userId}
+Content-Type: application/json
+```
+
+**Path Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Request Body:**
+```json
+{
+  "username": "updated_user",
+  "email": "updated@example.com",
+  "password": "newpassword456"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "username": "updated_user",
+  "email": "updated@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:10:00Z"
+}
+```
+
+---
+
+### 1.5 사용자 삭제
+
+사용자를 삭제합니다. 연관된 프로필 이미지와 상태 정보도 함께 삭제됩니다.
+
+```http
+DELETE /users/{userId}
+```
+
+**Path Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Response (204 No Content)**
+
+---
+
+### 1.6 온라인 상태 업데이트
+
+사용자의 온라인 상태를 업데이트합니다.
+
+```http
+PUT /users/{userId}/status
+Content-Type: application/json
+```
+
+**Path Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Request Body:**
+```json
+{
+  "lastActiveAt": "2026-02-09T08:00:00Z"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "userId": "uuid",
+  "lastActiveAt": "2026-02-09T08:00:00Z",
+  "id": "uuid",
+  "createdAt": "2026-02-09T07:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z",
+  "online": true
+}
+```
+
+---
+
+## 2. 권한 관리
+
+### 2.1 로그인
+
+사용자명과 비밀번호로 로그인합니다.
+
+```http
+POST /auth/login
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "username": "testuser",
+  "password": "password123"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "username": "testuser",
+  "email": "test@example.com",
+  "profileId": null,
+  "isOnline": true,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+**Error (404 Not Found):**
+```json
+{
+  "message": "Invalid username or password",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+## 3. 채널 관리
+
+### 3.1 공개 채널 생성
+
+PUBLIC 타입의 채널을 생성합니다.
+
+```http
+POST /channels/public
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "name": "일반 대화",
+  "description": "자유롭게 대화하는 채널"
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "id": "uuid",
+  "type": "PUBLIC",
+  "name": "일반 대화",
+  "description": "자유롭게 대화하는 채널",
+  "participantIds": null,
+  "lastMessageAt": null,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 3.2 비공개 채널 생성
+
+PRIVATE 타입의 채널을 생성합니다. 참여자 목록이 필수입니다.
+
+```http
+POST /channels/private
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "memberIds": [
+    "user-uuid-1",
+    "user-uuid-2"
+  ]
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "id": "uuid",
+  "type": "PRIVATE",
+  "name": null,
+  "description": null,
+  "participantIds": [
+    "user-uuid-1",
+    "user-uuid-2"
+  ],
+  "lastMessageAt": null,
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 3.3 사용자별 채널 목록 조회
+
+특정 사용자가 볼 수 있는 모든 채널을 조회합니다.
+- PUBLIC 채널: 모두 조회 가능
+- PRIVATE 채널: 참여자만 조회 가능
+
+```http
+GET /channels?userId={userId}
+```
+
+**Query Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Response (200 OK):**
+```json
+[
+  {
+    "id": "uuid",
+    "type": "PUBLIC",
+    "name": "일반 대화",
+    "description": "자유롭게 대화하는 채널",
+    "participantIds": null,
+    "lastMessageAt": "2026-02-09T07:50:00Z",
+    "createdAt": "2026-02-09T07:00:00Z",
+    "updatedAt": "2026-02-09T07:00:00Z"
+  },
+  {
+    "id": "uuid",
+    "type": "PRIVATE",
+    "name": null,
+    "description": null,
+    "participantIds": ["uuid1", "uuid2"],
+    "lastMessageAt": null,
+    "createdAt": "2026-02-09T08:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  }
+]
+```
+
+---
+
+### 3.4 특정 채널 조회
+
+특정 채널의 상세 정보를 조회합니다.
+
+```http
+GET /channels/{channelId}
+```
+
+**Path Parameters:**
+- `channelId` (UUID, required): 채널 ID
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "type": "PUBLIC",
+  "name": "일반 대화",
+  "description": "자유롭게 대화하는 채널",
+  "participantIds": null,
+  "lastMessageAt": "2026-02-09T07:50:00Z",
+  "createdAt": "2026-02-09T07:00:00Z",
+  "updatedAt": "2026-02-09T07:00:00Z"
+}
+```
+
+---
+
+### 3.5 채널 정보 수정
+
+PUBLIC 채널의 정보를 수정합니다. PRIVATE 채널은 수정할 수 없습니다.
+
+```http
+PUT /channels/{channelId}
+Content-Type: application/json
+```
+
+**Path Parameters:**
+- `channelId` (UUID, required): 채널 ID
+
+**Request Body:**
+```json
+{
+  "name": "수정된 채널명",
+  "description": "수정된 설명"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "type": "PUBLIC",
+  "name": "수정된 채널명",
+  "description": "수정된 설명",
+  "participantIds": null,
+  "lastMessageAt": "2026-02-09T07:50:00Z",
+  "createdAt": "2026-02-09T07:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+**Error (400 Bad Request) - PRIVATE 채널 수정 시도:**
+```json
+{
+  "message": "Private channel cannot be updated",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 3.6 채널 삭제
+
+채널을 삭제합니다. 연관된 메시지, 첨부파일, ReadStatus도 함께 삭제됩니다.
+
+```http
+DELETE /channels/{channelId}
+```
+
+**Path Parameters:**
+- `channelId` (UUID, required): 채널 ID
+
+**Response (204 No Content)**
+
+---
+
+## 4. 메시지 관리
+
+### 4.1 메시지 전송
+
+채널에 새로운 메시지를 전송합니다.
+
+```http
+POST /messages
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "content": "안녕하세요! 테스트 메시지입니다.",
+  "channelId": "channel-uuid",
+  "authorId": "user-uuid"
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "id": "uuid",
+  "content": "안녕하세요! 테스트 메시지입니다.",
+  "channelId": "channel-uuid",
+  "authorId": "user-uuid",
+  "attachmentIds": [],
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 4.2 채널별 메시지 조회
+
+특정 채널의 모든 메시지를 조회합니다.
+
+```http
+GET /messages?channelId={channelId}
+```
+
+**Query Parameters:**
+- `channelId` (UUID, required): 채널 ID
+
+**Response (200 OK):**
+```json
+[
+  {
+    "id": "uuid",
+    "content": "안녕하세요! 테스트 메시지입니다.",
+    "channelId": "channel-uuid",
+    "authorId": "user-uuid",
+    "attachmentIds": [],
+    "createdAt": "2026-02-09T08:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  }
+]
+```
+
+---
+
+### 4.3 특정 메시지 조회
+
+특정 메시지의 상세 정보를 조회합니다.
+
+```http
+GET /messages/{messageId}
+```
+
+**Path Parameters:**
+- `messageId` (UUID, required): 메시지 ID
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "content": "안녕하세요! 테스트 메시지입니다.",
+  "channelId": "channel-uuid",
+  "authorId": "user-uuid",
+  "attachmentIds": [],
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 4.4 메시지 수정
+
+메시지 내용을 수정합니다.
+
+```http
+PUT /messages/{messageId}
+Content-Type: application/json
+```
+
+**Path Parameters:**
+- `messageId` (UUID, required): 메시지 ID
+
+**Request Body:**
+```json
+{
+  "content": "수정된 메시지 내용"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "content": "수정된 메시지 내용",
+  "channelId": "channel-uuid",
+  "authorId": "user-uuid",
+  "attachmentIds": [],
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:10:00Z"
+}
+```
+
+---
+
+### 4.5 메시지 삭제
+
+메시지를 삭제합니다. 연관된 첨부파일도 함께 삭제됩니다.
+
+```http
+DELETE /messages/{messageId}
+```
+
+**Path Parameters:**
+- `messageId` (UUID, required): 메시지 ID
+
+**Response (204 No Content)**
+
+---
+
+## 5. 메시지 수신 정보 관리
+
+### 5.1 수신 정보 생성
+
+특정 채널의 메시지 수신 정보를 생성합니다.
+
+```http
+POST /read-status
+Content-Type: application/json
+```
+
+**Request Body:**
+```json
+{
+  "userId": "user-uuid",
+  "channelId": "channel-uuid",
+  "lastReadAt": "2026-02-09T08:00:00Z"
+}
+```
+
+**Response (201 Created):**
+```json
+{
+  "userId": "user-uuid",
+  "channelId": "channel-uuid",
+  "lastReadAt": "2026-02-09T08:00:00Z",
+  "id": "uuid",
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 5.2 수신 정보 수정
+
+메시지 수신 정보를 업데이트합니다.
+
+```http
+PUT /read-status/{readStatusId}
+Content-Type: application/json
+```
+
+**Path Parameters:**
+- `readStatusId` (UUID, required): 수신 정보 ID
+
+**Request Body:**
+```json
+{
+  "lastReadAt": "2026-02-09T09:00:00Z"
+}
+```
+
+**Response (200 OK):**
+```json
+{
+  "userId": "user-uuid",
+  "channelId": "channel-uuid",
+  "lastReadAt": "2026-02-09T09:00:00Z",
+  "id": "uuid",
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T09:00:00Z"
+}
+```
+
+---
+
+### 5.3 사용자별 수신 정보 조회
+
+특정 사용자의 모든 메시지 수신 정보를 조회합니다.
+
+```http
+GET /read-status?userId={userId}
+```
+
+**Query Parameters:**
+- `userId` (UUID, required): 사용자 ID
+
+**Response (200 OK):**
+```json
+[
+  {
+    "userId": "user-uuid",
+    "channelId": "channel-uuid-1",
+    "lastReadAt": "2026-02-09T08:00:00Z",
+    "id": "uuid-1",
+    "createdAt": "2026-02-09T07:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  },
+  {
+    "userId": "user-uuid",
+    "channelId": "channel-uuid-2",
+    "lastReadAt": "2026-02-09T07:30:00Z",
+    "id": "uuid-2",
+    "createdAt": "2026-02-09T07:00:00Z",
+    "updatedAt": "2026-02-09T07:30:00Z"
+  }
+]
+```
+
+---
+
+## 6. 바이너리 파일 관리
+
+### 6.1 파일 1개 조회
+
+특정 바이너리 파일을 조회합니다.
+
+```http
+GET /binary-contents/{binaryContentId}
+```
+
+**Path Parameters:**
+- `binaryContentId` (UUID, required): 바이너리 콘텐츠 ID
+
+**Response (200 OK):**
+```json
+{
+  "id": "uuid",
+  "fileName": "test.png",
+  "contentType": "image/png",
+  "data": "base64-encoded-data",
+  "createdAt": "2026-02-09T08:00:00Z",
+  "updatedAt": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+### 6.2 파일 여러 개 조회
+
+여러 바이너리 파일을 한 번에 조회합니다.
+
+```http
+GET /binary-contents?ids={id1},{id2},{id3}
+```
+
+**Query Parameters:**
+- `ids` (comma-separated UUIDs, required): 바이너리 콘텐츠 ID 목록
+
+**Response (200 OK):**
+```json
+[
+  {
+    "id": "uuid-1",
+    "fileName": "file1.txt",
+    "contentType": "text/plain",
+    "data": "base64-encoded-data-1",
+    "createdAt": "2026-02-09T08:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  },
+  {
+    "id": "uuid-2",
+    "fileName": "file2.png",
+    "contentType": "image/png",
+    "data": "base64-encoded-data-2",
+    "createdAt": "2026-02-09T08:00:00Z",
+    "updatedAt": "2026-02-09T08:00:00Z"
+  }
+]
+```
+
+---
+
+## 공통 에러 응답
+
+### 400 Bad Request
+잘못된 요청 형식
+
+```json
+{
+  "message": "Invalid request format",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+### 404 Not Found
+리소스를 찾을 수 없음
+
+```json
+{
+  "message": "Resource not found: {resourceId}",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+### 500 Internal Server Error
+서버 내부 오류
+
+```json
+{
+  "message": "서버 내부 오류가 발생했습니다: {error details}",
+  "timestamp": "2026-02-09T08:00:00Z"
+}
+```
+
+---
+
+## 테스트 순서 권장사항
+
+### 기본 플로우
+1. 사용자 등록
+2. 로그인
+3. 공개 채널 생성
+4. 메시지 전송
+5. 메시지 조회
+6. 메시지 수정
+7. 온라인 상태 업데이트
+
+### 비공개 채널 플로우
+1. 사용자 2명 등록
+2. 비공개 채널 생성 (두 사용자 초대)
+3. 각 사용자별 채널 목록 조회
+4. 메시지 수신 정보 생성
+5. 메시지 전송 및 조회
+
+---
+
+## 추가 리소스
+
+- **Postman Collection**: `Discodeit_API_Collection.postman_collection.json`
+- **Environment File**: `Discodeit_Environment.postman_environment.json`
+- **Python 자동화 스크립트**: `test_api_automation.py`
+- **Bash 테스트 스크립트**: `/tmp/test_discodeit_api.sh`
+
+---
+
+**문서 버전**: 1.0
+**최종 수정일**: 2026-02-09
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_GUIDE.md b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_GUIDE.md
new file mode 100644
index 00000000..911c542f
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_GUIDE.md
@@ -0,0 +1,308 @@
+# 📮 Postman 사용 가이드
+
+디스코드잇 API를 Postman으로 테스트하는 완벽 가이드입니다.
+
+---
+
+## 🚀 빠른 시작
+
+### 1단계: 파일 Import
+
+#### ✅ Collection Import
+1. Postman 실행
+2. **Import** 버튼 클릭
+3. `Discodeit_API_Collection.postman_collection.json` 파일 선택
+4. **Import** 클릭
+
+#### ✅ Environment Import
+1. Postman에서 **Environments** 탭 선택
+2. **Import** 버튼 클릭
+3. `Discodeit_Environment.postman_environment.json` 파일 선택
+4. **Import** 클릭
+
+### 2단계: Environment 선택
+
+우측 상단의 Environment 드롭다운에서 **"Discodeit Local"** 선택
+
+### 3단계: 애플리케이션 실행
+
+터미널에서:
+```bash
+cd /Users/ijongho/IdeaProjects/9-sprint-mission/discodeit
+./gradlew bootRun
+```
+
+또는 IDE에서 Spring Boot 애플리케이션 실행
+
+### 4단계: API 테스트 시작!
+
+Collection에서 원하는 API 선택 → **Send** 버튼 클릭
+
+---
+
+## 📂 Collection 구조
+
+```
+디스코드잇 API
+├── 1. 사용자 관리
+│   ├── 사용자 등록 ← 여기서 시작!
+│   ├── 전체 사용자 조회
+│   ├── 특정 사용자 조회
+│   ├── 사용자 수정
+│   ├── 사용자 삭제
+│   └── 온라인 상태 업데이트
+├── 2. 권한 관리
+│   └── 로그인
+├── 3. 채널 관리
+│   ├── 공개 채널 생성
+│   ├── 비공개 채널 생성
+│   ├── 사용자별 채널 목록 조회
+│   ├── 특정 채널 조회
+│   ├── 채널 수정
+│   └── 채널 삭제
+├── 4. 메시지 관리
+│   ├── 메시지 전송
+│   ├── 채널별 메시지 조회
+│   ├── 특정 메시지 조회
+│   ├── 메시지 수정
+│   └── 메시지 삭제
+├── 5. 메시지 수신 정보
+│   ├── 수신 정보 생성
+│   ├── 수신 정보 수정
+│   └── 사용자별 수신 정보 조회
+└── 6. 바이너리 파일
+    ├── 파일 1개 조회
+    └── 파일 여러 개 조회
+```
+
+---
+
+## 🎯 테스트 시나리오
+
+### 시나리오 1: 기본 플로우 (추천)
+
+**목표**: 사용자 생성 → 채널 생성 → 메시지 전송
+
+1. **사용자 등록**
+   - `1. 사용자 관리 > 사용자 등록` 실행
+   - ✅ userId가 자동으로 Environment에 저장됨
+
+2. **로그인**
+   - `2. 권한 관리 > 로그인` 실행
+   - ✅ 로그인 성공 확인
+
+3. **공개 채널 생성**
+   - `3. 채널 관리 > 공개 채널 생성` 실행
+   - ✅ channelId가 자동으로 Environment에 저장됨
+
+4. **메시지 전송**
+   - `4. 메시지 관리 > 메시지 전송` 실행
+   - ✅ messageId가 자동으로 Environment에 저장됨
+
+5. **메시지 조회**
+   - `4. 메시지 관리 > 채널별 메시지 조회` 실행
+   - ✅ 방금 전송한 메시지 확인
+
+6. **메시지 수정**
+   - `4. 메시지 관리 > 메시지 수정` 실행
+   - ✅ 메시지 내용 변경 확인
+
+---
+
+### 시나리오 2: 비공개 채널
+
+**목표**: 비공개 채널 생성 및 참여자 관리
+
+1. **사용자 2명 등록**
+   - 첫 번째 사용자 등록 → userId1 복사
+   - Body의 username, email 변경 후 다시 실행 → userId2 복사
+
+2. **비공개 채널 생성**
+   - `3. 채널 관리 > 비공개 채널 생성`
+   - Body 수정:
+   ```json
+   {
+     "memberIds": [
+       "{{userId}}",  // 첫 번째 사용자
+       "paste-userId2-here"  // 두 번째 사용자
+     ]
+   }
+   ```
+
+3. **채널 목록 조회**
+   - Environment의 userId를 첫 번째 사용자로 설정
+   - `3. 채널 관리 > 사용자별 채널 목록 조회`
+   - ✅ 비공개 채널 포함 확인
+
+   - Environment의 userId를 두 번째 사용자로 설정
+   - 다시 조회
+   - ✅ 같은 비공개 채널 확인
+
+---
+
+### 시나리오 3: CRUD 전체 테스트
+
+**목표**: 생성-조회-수정-삭제 전체 플로우
+
+#### 사용자 CRUD
+```
+생성 → 조회 → 수정 → 삭제
+```
+
+#### 채널 CRUD
+```
+생성 → 조회 → 수정 → 삭제
+```
+
+#### 메시지 CRUD
+```
+전송 → 조회 → 수정 → 삭제
+```
+
+---
+
+## 🔧 Environment 변수
+
+| 변수명 | 설명 | 자동 저장 |
+|--------|------|----------|
+| `baseUrl` | API 기본 URL | ❌ 수동 |
+| `userId` | 생성된 사용자 ID | ✅ 자동 |
+| `channelId` | 생성된 채널 ID | ✅ 자동 |
+| `messageId` | 생성된 메시지 ID | ✅ 자동 |
+| `readStatusId` | 생성된 수신정보 ID | ✅ 자동 |
+| `binaryContentId` | 업로드된 파일 ID | ❌ 수동 |
+
+### 변수 확인 방법
+
+1. 우측 상단 Environment 아이콘 클릭
+2. "Discodeit Local" 선택
+3. **Current Value** 컬럼에서 저장된 값 확인
+
+### 변수 수동 설정
+
+1. Environment 편집 화면에서 **Current Value** 입력
+2. 또는 **Console** (하단)에서 자동 저장 로그 확인:
+   ```
+   사용자 ID 저장: uuid-value
+   채널 ID 저장: uuid-value
+   ```
+
+---
+
+## 💡 유용한 팁
+
+### 1️⃣ Tests 스크립트
+
+각 요청에는 자동으로 ID를 저장하는 스크립트가 포함되어 있습니다:
+
+```javascript
+// 사용자 등록 후 자동 실행
+if (pm.response.code === 201) {
+    var jsonData = pm.response.json();
+    pm.environment.set("userId", jsonData.id);
+    console.log("사용자 ID 저장:", jsonData.id);
+}
+```
+
+### 2️⃣ 응답 자동 포맷팅
+
+Postman이 자동으로 JSON을 보기 좋게 포맷팅합니다.
+- **Pretty** 탭: 읽기 편한 형식
+- **Raw** 탭: 원본 JSON
+- **Preview** 탭: HTML 렌더링 (해당 시)
+
+### 3️⃣ Collection Runner
+
+전체 API를 자동으로 테스트:
+
+1. Collection 우클릭 → **Run collection**
+2. 실행할 요청 선택
+3. **Run** 버튼 클릭
+4. ✅ 전체 테스트 결과 확인
+
+### 4️⃣ 요청 복사
+
+특정 요청을 curl로 변환:
+
+1. 요청 우클릭 → **Export** → **Request**
+2. 또는 **Code** 아이콘 클릭 → curl 선택
+
+---
+
+## 🐛 문제 해결
+
+### 문제 1: "baseUrl is not defined"
+
+**원인**: Environment가 선택되지 않음
+
+**해결**:
+1. 우측 상단에서 "Discodeit Local" 선택
+2. Environment 변수 확인
+
+### 문제 2: "Failed to connect"
+
+**원인**: Spring Boot 애플리케이션이 실행되지 않음
+
+**해결**:
+```bash
+# 애플리케이션 실행 확인
+lsof -i :8080
+
+# 실행되지 않았다면
+./gradlew bootRun
+```
+
+### 문제 3: "User not found" / "Channel not found"
+
+**원인**: Environment 변수가 비어있거나 잘못된 UUID
+
+**해결**:
+1. 사용자 등록부터 다시 시작
+2. Environment의 `userId`, `channelId` 확인
+
+### 문제 4: "Required request body is missing"
+
+**원인**: Body 탭에서 raw + JSON이 선택되지 않음
+
+**해결**:
+1. Body 탭 클릭
+2. **raw** 선택
+3. 우측 드롭다운에서 **JSON** 선택
+
+---
+
+## 📊 추가 도구
+
+### Bash 스크립트
+전체 API를 터미널에서 테스트:
+```bash
+/tmp/test_discodeit_api.sh
+```
+
+### Python 스크립트
+프로그래밍 방식으로 API 테스트:
+```bash
+# 의존성 설치
+pip install -r requirements.txt
+
+# 실행
+python test_api_automation.py
+```
+
+### API 문서
+상세한 API 문서:
+```
+API_DOCUMENTATION.md
+```
+
+---
+
+## 📞 도움이 필요하신가요?
+
+- **API 문서**: `API_DOCUMENTATION.md` 참조
+- **에러 로그**: Postman Console (하단) 확인
+- **서버 로그**: Spring Boot 애플리케이션 콘솔 확인
+
+---
+
+**Happy Testing! 🎉**
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_SETUP_GUIDE_v2.md b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_SETUP_GUIDE_v2.md
new file mode 100644
index 00000000..c1ea16ab
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/POSTMAN_SETUP_GUIDE_v2.md
@@ -0,0 +1,335 @@
+# 📮 Postman 완벽 가이드 v2 (개선 버전)
+
+## 🎯 주요 개선사항
+
+### ✅ 해결된 문제
+
+**이전 버전의 문제:**
+- ❌ 사용자 삭제 후 온라인 상태 업데이트 실패
+- ❌ 채널 삭제 후 메시지 테스트 실패
+- ❌ 삭제 테스트로 인한 연쇄 실패
+
+**v2의 해결책:**
+- ✅ **사용자 3명 미리 생성** (user1, user2, user3)
+- ✅ **채널 3개 미리 생성** (일반, 공지, 질문)
+- ✅ **삭제용 리소스 분리** (user3, channel3 삭제 전용)
+- ✅ **삭제 후에도 계속 테스트 가능**
+
+---
+
+## 🚀 빠른 시작
+
+### 1단계: Import
+
+#### Collection Import
+1. Postman 실행
+2. **Import** 버튼 클릭
+3. `Discodeit_API_Collection_v2.postman_collection.json` 선택
+4. **Import** 클릭
+
+#### Environment Import
+1. **Environments** 탭
+2. **Import** 버튼 클릭
+3. `Discodeit_Environment_v2.postman_environment.json` 선택
+4. **Import** 클릭
+
+### 2단계: Environment 선택
+
+우측 상단에서 **"Discodeit Local v2"** 선택
+
+### 3단계: 애플리케이션 실행
+
+터미널에서:
+```bash
+cd /Users/ijongho/IdeaProjects/9-sprint-mission/discodeit
+./gradlew bootRun
+```
+
+### 4단계: 초기 설정 실행 ⚠️ 중요!
+
+**가장 먼저 실행해야 합니다:**
+
+```
+Collection > 0. 초기 설정 (먼저 실행)
+```
+
+**Collection Runner 사용 (권장):**
+1. "0. 초기 설정" 폴더 우클릭
+2. **Run folder** 선택
+3. **Run** 버튼 클릭
+4. 6개 API가 순차 실행됨:
+   - 사용자 1, 2, 3 등록
+   - 채널 1, 2, 3 생성
+
+**또는 수동으로:**
+1. 사용자 1 등록 → Send
+2. 사용자 2 등록 → Send
+3. 사용자 3 등록 → Send
+4. 채널 1 생성 → Send
+5. 채널 2 생성 → Send
+6. 채널 3 생성 → Send
+
+---
+
+## 📂 Collection 구조 v2
+
+```
+디스코드잇 API v2
+├── 0. 초기 설정 (먼저 실행) ⭐ 가장 중요!
+│   ├── 사용자 1 등록
+│   ├── 사용자 2 등록
+│   ├── 사용자 3 등록
+│   ├── 채널 1 생성 (일반)
+│   ├── 채널 2 생성 (공지)
+│   └── 채널 3 생성 (질문)
+├── 1. 사용자 관리
+│   ├── 전체 사용자 조회
+│   ├── 사용자1 조회
+│   ├── 사용자2 정보 수정
+│   ├── 사용자3 삭제 (테스트용) ← 삭제해도 user1, user2 남음
+│   └── 사용자1 온라인 상태 업데이트
+├── 2. 권한 관리
+│   ├── user1 로그인
+│   └── user2 로그인
+├── 3. 채널 관리
+│   ├── user1의 채널 목록 조회
+│   ├── 채널1 조회
+│   ├── 채널2 정보 수정
+│   ├── 채널3 삭제 (테스트용) ← 삭제해도 채널1, 채널2 남음
+│   └── 비공개 채널 생성 (user1, user2)
+├── 4. 메시지 관리
+│   ├── 채널1에 메시지 전송 (user1)
+│   ├── 채널1에 메시지 전송 (user2)
+│   ├── 채널1의 메시지 목록 조회
+│   ├── 메시지1 조회
+│   ├── 메시지1 수정
+│   └── 메시지2 삭제 (테스트용) ← 삭제해도 메시지1 남음
+├── 5. 메시지 수신 정보
+│   ├── 채널1 수신 정보 생성 (user1)
+│   ├── 수신 정보 수정
+│   └── user1의 수신 정보 조회
+└── 6. 바이너리 파일
+    ├── 파일 1개 조회
+    └── 파일 여러 개 조회
+```
+
+---
+
+## 🎯 테스트 시나리오
+
+### 시나리오 1: 전체 플로우 (추천)
+
+**목표**: 초기 설정부터 메시지 전송까지 전체 테스트
+
+```
+1. 초기 설정 실행 (0번 폴더)
+   ↓
+2. user1 로그인
+   ↓
+3. 채널1의 메시지 목록 조회
+   ↓
+4. 채널1에 메시지 전송
+   ↓
+5. 메시지 수정
+   ↓
+6. 온라인 상태 업데이트
+```
+
+### 시나리오 2: 삭제 테스트
+
+**목표**: 삭제 후에도 다른 리소스로 계속 테스트
+
+```
+1. 초기 설정 실행
+   ↓
+2. 사용자3 삭제 ← user1, user2는 남아있음
+   ↓
+3. user1으로 로그인 ← 정상 작동 ✅
+   ↓
+4. 채널3 삭제 ← 채널1, 채널2는 남아있음
+   ↓
+5. 채널1에 메시지 전송 ← 정상 작동 ✅
+```
+
+### 시나리오 3: 여러 사용자 테스트
+
+**목표**: 여러 사용자가 동시에 활동하는 상황
+
+```
+1. 초기 설정 실행
+   ↓
+2. user1 로그인
+   ↓
+3. user2 로그인
+   ↓
+4. user1이 채널1에 메시지 전송
+   ↓
+5. user2가 채널1에 메시지 전송
+   ↓
+6. 채널1의 메시지 목록 조회 ← 2개 메시지 확인
+```
+
+---
+
+## 🔧 Environment 변수 v2
+
+| 변수명 | 설명 | 자동 저장 |
+|--------|------|----------|
+| `baseUrl` | API 기본 URL | ❌ 수동 |
+| `userId1` | 사용자1 ID | ✅ 자동 |
+| `userId2` | 사용자2 ID | ✅ 자동 |
+| `userId3` | 사용자3 ID (삭제용) | ✅ 자동 |
+| `channelId1` | 채널1 ID (일반) | ✅ 자동 |
+| `channelId2` | 채널2 ID (공지) | ✅ 자동 |
+| `channelId3` | 채널3 ID (삭제용) | ✅ 자동 |
+| `privateChannelId` | 비공개 채널 ID | ✅ 자동 |
+| `messageId1` | 메시지1 ID | ✅ 자동 |
+| `messageId2` | 메시지2 ID (삭제용) | ✅ 자동 |
+| `readStatusId1` | 수신정보1 ID | ✅ 자동 |
+| `binaryContentId` | 파일 ID | ❌ 수동 |
+
+---
+
+## 💡 삭제 테스트 전략
+
+### ✅ 안전한 삭제 테스트
+
+**삭제 전용 리소스:**
+- `user3` → 삭제 후에도 user1, user2 사용 가능
+- `channel3` → 삭제 후에도 채널1, 채널2 사용 가능
+- `message2` → 삭제 후에도 메시지1 사용 가능
+
+**일반 리소스 (삭제하지 않음):**
+- `user1`, `user2` → 지속적으로 사용
+- `channel1`, `channel2` → 지속적으로 사용
+- `message1` → 지속적으로 사용
+
+---
+
+## 📊 Collection Runner 활용
+
+### 전체 자동 테스트
+
+**1. 초기 설정 자동 실행:**
+```
+"0. 초기 설정" 폴더 우클릭 → Run folder
+```
+
+**2. 전체 Collection 실행:**
+```
+Collection 우클릭 → Run collection
+→ 순서 확인 → Run
+```
+
+**3. 결과 확인:**
+- ✅ Passed: 성공한 테스트
+- ❌ Failed: 실패한 테스트
+- 상세 로그 확인 가능
+
+---
+
+## ⚠️ 주의사항
+
+### 1. 초기 설정 필수
+
+**모든 테스트 전에 "0. 초기 설정" 실행 필수!**
+
+실행하지 않으면:
+- ❌ 로그인 실패 (404 Not Found)
+- ❌ 채널 조회 실패
+- ❌ 모든 테스트 실패
+
+### 2. 애플리케이션 재시작 시
+
+**데이터 초기화됨 (메모리 DB):**
+
+```
+애플리케이션 재시작
+   ↓
+모든 데이터 삭제
+   ↓
+"0. 초기 설정" 다시 실행
+```
+
+### 3. 삭제 테스트 순서
+
+**권장 순서:**
+
+```
+✅ 일반 테스트 먼저
+   ↓
+✅ 삭제 테스트 나중에
+```
+
+**비권장:**
+```
+❌ 삭제 테스트 먼저 → 일반 테스트 실패
+```
+
+---
+
+## 🔄 데이터 리셋
+
+### Collection Runner로 초기화
+
+**전체 리셋:**
+```
+1. "0. 초기 설정" 폴더 Run
+   → 새로운 사용자/채널 생성
+
+2. Environment 변수 자동 업데이트
+   → 새 ID로 교체됨
+```
+
+---
+
+## 💻 Postman 변수 팁
+
+### 동적 변수 사용
+
+**현재 시간 자동 생성:**
+```json
+{
+  "lastActiveAt": "{{$isoTimestamp}}"
+}
+```
+
+**UUID 자동 생성:**
+```json
+{
+  "id": "{{$guid}}"
+}
+```
+
+**랜덤 이메일:**
+```json
+{
+  "email": "user{{$randomInt}}@example.com"
+}
+```
+
+---
+
+## 🎊 v2의 장점
+
+### ✅ 개선된 테스트 안정성
+
+| 항목 | v1 | v2 |
+|------|----|----|
+| 사용자 삭제 후 | ❌ 테스트 실패 | ✅ 계속 테스트 가능 |
+| 채널 삭제 후 | ❌ 테스트 실패 | ✅ 계속 테스트 가능 |
+| 초기 설정 | ❌ 수동으로 하나씩 | ✅ 폴더 한 번 실행 |
+| 여러 사용자 | ❌ 1명만 | ✅ 3명 동시 테스트 |
+| 여러 채널 | ❌ 1개만 | ✅ 3개 동시 테스트 |
+
+---
+
+## 📚 추가 문서
+
+- **API_DOCUMENTATION.md**: 전체 API 상세 문서
+- **TROUBLESHOOTING.md**: 문제 해결 가이드
+- **test_api_automation.py**: Python 자동화 스크립트
+
+---
+
+**Happy Testing with v2! 🎉**
diff --git "a/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README4(SB3\354\235\264\354\242\205\355\230\270).md" "b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README4(SB3\354\235\264\354\242\205\355\230\270).md"
new file mode 100644
index 00000000..09028a02
--- /dev/null
+++ "b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README4(SB3\354\235\264\354\242\205\355\230\270).md"
@@ -0,0 +1,845 @@
+# Discodeit 프로젝트 - 초보자를 위한 완전 가이드
+
+> Spring Boot 3 기반 Discord 클론 프로젝트의 구조와 코드를 초보자 관점에서 상세히 설명합니다.
+
+---
+
+## 목차
+
+1. [프로젝트 개요](#1-프로젝트-개요)
+2. [패키지 구조](#2-패키지-구조)
+3. [계층형 아키텍처 이해하기](#3-계층형-아키텍처-이해하기)
+4. [Entity 계층 - 데이터의 뼈대](#4-entity-계층---데이터의-뼈대)
+5. [DTO 계층 - 데이터 전달 객체](#5-dto-계층---데이터-전달-객체)
+6. [Repository 계층 - 데이터 저장소](#6-repository-계층---데이터-저장소)
+7. [Service 계층 - 비즈니스 로직](#7-service-계층---비즈니스-로직)
+8. [전체 데이터 흐름 예시](#8-전체-데이터-흐름-예시)
+9. [직접 구현해보기](#9-직접-구현해보기)
+10. [자주 하는 실수와 해결법](#10-자주-하는-실수와-해결법)
+
+---
+
+## 1. 프로젝트 개요
+
+### 1.1 이 프로젝트는 무엇인가요?
+
+**Discodeit**은 Discord와 유사한 채팅 애플리케이션의 백엔드입니다.
+
+주요 기능:
+- **사용자 관리**: 회원가입, 로그인, 프로필 관리
+- **채널 관리**: 공개/비공개 채널 생성 및 관리
+- **메시지**: 채널 내 메시지 송수신
+- **파일 첨부**: 프로필 이미지, 메시지 첨부파일
+- **상태 관리**: 온라인/오프라인 상태, 메시지 읽음 상태
+
+### 1.2 사용 기술
+
+| 기술 | 용도 |
+|------|------|
+| Java 17+ | 프로그래밍 언어 |
+| Spring Boot 3 | 웹 프레임워크 |
+| Lombok | 보일러플레이트 코드 자동 생성 |
+| UUID | 고유 식별자 생성 |
+
+---
+
+## 2. 패키지 구조
+
+```
+src/main/java/com/sprint/mission/discodeit/
+│
+├── DiscodeitApplication.java    # 애플리케이션 시작점
+│
+├── entity/                      # 📦 엔티티 (데이터 모델)
+│   ├── BaseEntity.java         # 모든 엔티티의 부모 클래스
+│   ├── User.java               # 사용자
+│   ├── Channel.java            # 채널
+│   ├── Message.java            # 메시지
+│   ├── BinaryContent.java      # 파일 (이미지, 첨부파일)
+│   ├── UserStatus.java         # 사용자 온라인 상태
+│   ├── ReadStatus.java         # 메시지 읽음 상태
+│   └── ChannelType.java        # 채널 타입 (PUBLIC/PRIVATE)
+│
+├── dto/                         # 📨 데이터 전송 객체
+│   ├── request/                # 요청용 DTO
+│   │   ├── UserCreateRequest.java
+│   │   ├── UserUpdateRequest.java
+│   │   └── ...
+│   └── response/               # 응답용 DTO
+│       ├── UserResponse.java
+│       └── ...
+│
+├── repository/                  # 💾 저장소 (데이터 접근)
+│   ├── UserRepository.java     # 인터페이스
+│   ├── file/                   # 파일 기반 구현체
+│   │   └── FileUserRepository.java
+│   └── jcf/                    # 메모리 기반 구현체
+│       └── JCFUserRepository.java
+│
+└── service/                     # ⚙️ 서비스 (비즈니스 로직)
+    ├── UserService.java        # 인터페이스
+    └── basic/                  # 기본 구현체
+        └── BasicUserService.java
+```
+
+### 왜 이렇게 나눌까요?
+
+각 패키지는 **하나의 역할**만 담당합니다:
+- **entity**: "데이터가 어떻게 생겼는지" 정의
+- **dto**: "어떤 데이터를 주고받을지" 정의
+- **repository**: "데이터를 어떻게 저장/조회할지" 정의
+- **service**: "어떤 작업을 수행할지" 정의
+
+이렇게 나누면 **수정이 쉽고**, **테스트가 쉽고**, **이해하기 쉽습니다**.
+
+---
+
+## 3. 계층형 아키텍처 이해하기
+
+### 3.1 계층 구조 다이어그램
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    클라이언트 (Frontend)                  │
+└─────────────────────────────────────────────────────────┘
+                            │
+                            ▼ HTTP 요청/응답
+┌─────────────────────────────────────────────────────────┐
+│                  Controller 계층 (REST API)              │
+│            - HTTP 요청을 받아서 Service에 전달             │
+│            - Service 결과를 HTTP 응답으로 반환             │
+└─────────────────────────────────────────────────────────┘
+                            │
+                            ▼ DTO 전달
+┌─────────────────────────────────────────────────────────┐
+│                    Service 계층                          │
+│            - 비즈니스 로직 처리                            │
+│            - 여러 Repository를 조합하여 작업 수행           │
+└─────────────────────────────────────────────────────────┘
+                            │
+                            ▼ Entity 전달
+┌─────────────────────────────────────────────────────────┐
+│                   Repository 계층                        │
+│            - 데이터 저장/조회/수정/삭제                     │
+│            - 파일 또는 메모리에 저장                        │
+└─────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+┌─────────────────────────────────────────────────────────┐
+│                    Entity 계층                           │
+│            - 데이터의 구조 정의                            │
+└─────────────────────────────────────────────────────────┘
+```
+
+### 3.2 데이터 흐름 방향
+
+```
+요청 시: 클라이언트 → Controller → Service → Repository → 저장소
+응답 시: 저장소 → Repository → Service → Controller → 클라이언트
+```
+
+**핵심 규칙**:
+- 상위 계층은 하위 계층을 호출할 수 있음
+- 하위 계층은 상위 계층을 몰라야 함 (의존성 방향 통일)
+
+---
+
+## 4. Entity 계층 - 데이터의 뼈대
+
+### 4.1 BaseEntity - 모든 엔티티의 부모
+
+모든 엔티티가 공통으로 가지는 속성을 정의합니다.
+
+```java
+@Getter
+public class BaseEntity implements Serializable {
+
+    protected UUID id;           // 고유 식별자
+    protected Instant createdAt; // 생성 시간
+    protected Instant updatedAt; // 수정 시간
+
+    public BaseEntity() {
+        this.id = UUID.randomUUID();  // 자동으로 고유 ID 생성
+        Instant now = Instant.now();
+        this.createdAt = now;
+        this.updatedAt = now;
+    }
+
+    // 수정 시 호출하여 수정 시간 갱신
+    protected void updateTimeStamp() {
+        this.updatedAt = Instant.now();
+    }
+}
+```
+
+**왜 BaseEntity를 만들까요?**
+- 모든 데이터는 `id`, `createdAt`, `updatedAt`이 필요함
+- 중복 코드를 줄이고 일관성 유지
+- 상속을 통해 자동으로 공통 기능 획득
+
+### 4.2 User 엔티티
+
+```java
+@Getter
+public class User extends BaseEntity {
+
+    private String username;    // 사용자명 (로그인 ID)
+    private String email;       // 이메일
+    private String password;    // 비밀번호
+    private UUID profileId;     // 프로필 이미지 ID (선택)
+
+    // 생성자: 새 사용자 만들 때
+    public User(String username, String email, String password, UUID profileId) {
+        super();  // BaseEntity 생성자 호출 → id, createdAt, updatedAt 자동 설정
+        this.username = username;
+        this.email = email;
+        this.password = password;
+        this.profileId = profileId;
+    }
+
+    // 수정 메서드: null이 아닌 값만 업데이트
+    public void update(String username, String email, String password, UUID profileId) {
+        if (username != null) this.username = username;
+        if (email != null) this.email = email;
+        if (password != null) this.password = password;
+        if (profileId != null) this.profileId = profileId;
+        updateTimeStamp();  // 수정 시간 갱신
+    }
+}
+```
+
+**포인트 해설**:
+1. `extends BaseEntity`: 공통 속성 상속
+2. `super()`: 부모 생성자 호출로 id, 시간 자동 생성
+3. `update()`: null 체크로 부분 업데이트 가능
+4. `updateTimeStamp()`: 수정 시 자동으로 시간 갱신
+
+### 4.3 전체 엔티티 관계도
+
+```
+┌──────────────┐
+│  BaseEntity  │  ← 모든 엔티티의 부모
+└──────────────┘
+       △
+       │ 상속
+       │
+┌──────┴──────┬──────────────┬──────────────┬──────────────┐
+│             │              │              │              │
+▼             ▼              ▼              ▼              ▼
+┌──────┐   ┌──────┐   ┌─────────┐   ┌──────────┐   ┌───────────┐
+│ User │   │Channel│   │ Message │   │ReadStatus│   │UserStatus │
+└──────┘   └──────┘   └─────────┘   └──────────┘   └───────────┘
+    │          │           │             │               │
+    │          │           │             │               │
+    ▼          ▼           ▼             │               │
+┌──────────────────────────────────┐     │               │
+│        BinaryContent             │     │               │
+│   (프로필 이미지, 첨부파일)        │     │               │
+└──────────────────────────────────┘     │               │
+                                         │               │
+                                    사용자-채널        사용자
+                                    읽음 상태         온라인 상태
+```
+
+### 4.4 각 엔티티 요약
+
+| 엔티티 | 역할 | 주요 필드 |
+|--------|------|----------|
+| **User** | 사용자 정보 | username, email, password, profileId |
+| **Channel** | 채팅방 | type(PUBLIC/PRIVATE), name, description |
+| **Message** | 메시지 | content, channelId, authorId, attachmentIds |
+| **BinaryContent** | 파일 저장 | fileName, contentType, data(byte[]) |
+| **UserStatus** | 온라인 상태 | userId, lastActiveAt |
+| **ReadStatus** | 읽음 상태 | userId, channelId, lastReadAt |
+
+---
+
+## 5. DTO 계층 - 데이터 전달 객체
+
+### 5.1 DTO란?
+
+**DTO (Data Transfer Object)**: 계층 간 데이터를 전달하기 위한 객체
+
+**왜 Entity를 직접 안 쓰고 DTO를 쓸까요?**
+
+1. **보안**: 비밀번호 같은 민감한 정보 숨기기
+2. **유연성**: 클라이언트가 필요한 형태로 데이터 가공
+3. **분리**: Entity 변경이 API에 영향 주지 않음
+
+### 5.2 Request DTO - 요청용
+
+클라이언트가 서버로 데이터를 보낼 때 사용합니다.
+
+```java
+// 회원가입 요청 DTO
+public record UserCreateRequest(
+    String username,   // 사용자명
+    String email,      // 이메일
+    String password    // 비밀번호
+) {}
+```
+
+**record란?**
+- Java 16+에서 추가된 불변 데이터 클래스
+- 자동으로 생성자, getter, equals, hashCode, toString 생성
+- DTO에 적합!
+
+**전체 Request DTO 목록**:
+
+| DTO | 용도 | 필드 |
+|-----|------|------|
+| `UserCreateRequest` | 회원가입 | username, email, password |
+| `UserUpdateRequest` | 정보 수정 | username, email, password (모두 선택) |
+| `LoginRequest` | 로그인 | username, password |
+| `PublicChannelCreateRequest` | 공개 채널 생성 | name, description |
+| `PrivateChannelCreateRequest` | 비공개 채널 생성 | memberIds (List) |
+| `ChannelUpdateRequest` | 채널 수정 | name, description |
+| `MessageCreateRequest` | 메시지 작성 | content, channelId, authorId |
+| `MessageUpdateRequest` | 메시지 수정 | content |
+| `BinaryContentCreateRequest` | 파일 업로드 | fileName, contentType, data |
+
+### 5.3 Response DTO - 응답용
+
+서버가 클라이언트로 데이터를 보낼 때 사용합니다.
+
+```java
+// 사용자 응답 DTO
+public record UserResponse(
+    UUID id,              // 사용자 ID
+    String username,      // 사용자명
+    String email,         // 이메일
+    UUID profileId,       // 프로필 이미지 ID
+    boolean isOnline,     // 온라인 여부 ★ 추가 정보!
+    Instant createdAt,    // 생성 시간
+    Instant updatedAt     // 수정 시간
+) {}
+```
+
+**Entity vs Response DTO 비교**:
+
+| 항목 | User Entity | UserResponse DTO |
+|------|-------------|------------------|
+| password | ✅ 있음 | ❌ 없음 (보안) |
+| isOnline | ❌ 없음 | ✅ 있음 (추가 정보) |
+
+---
+
+## 6. Repository 계층 - 데이터 저장소
+
+### 6.1 Repository 패턴이란?
+
+데이터 저장/조회 로직을 **추상화**하여 Service가 저장 방식을 몰라도 되게 합니다.
+
+```
+Service: "User 저장해줘"
+    ↓
+Repository 인터페이스: save(User user)
+    ↓
+구현체 선택:
+    ├─ FileRepository → 파일에 저장
+    └─ JCFRepository → 메모리에 저장
+```
+
+### 6.2 Repository 인터페이스
+
+```java
+public interface UserRepository {
+
+    // 기본 CRUD
+    User save(User user);              // 저장/수정
+    Optional<User> findById(UUID id);  // ID로 조회
+    List<User> findAll();              // 전체 조회
+    void deleteById(UUID id);          // 삭제
+
+    // 조회 메서드
+    Optional<User> findByUsername(String username);  // 로그인용
+    Optional<User> findByEmail(String email);        // 이메일 조회
+
+    // 존재 여부 확인
+    boolean existsById(UUID id);
+    boolean existsByUsername(String username);  // 중복 체크용
+    boolean existsByEmail(String email);        // 중복 체크용
+}
+```
+
+**Optional이란?**
+- 값이 있을 수도, 없을 수도 있는 컨테이너
+- null 대신 사용하여 NullPointerException 방지
+
+```java
+// Optional 사용 예시
+Optional<User> userOpt = userRepository.findById(id);
+
+// 방법 1: 있으면 가져오고, 없으면 예외
+User user = userOpt.orElseThrow(() ->
+    new NoSuchElementException("User not found"));
+
+// 방법 2: 있으면 가져오고, 없으면 기본값
+User user = userOpt.orElse(defaultUser);
+
+// 방법 3: 있을 때만 처리
+userOpt.ifPresent(user -> System.out.println(user.getUsername()));
+```
+
+### 6.3 구현체 선택 방식
+
+**application.properties에서 설정**:
+
+```properties
+# 메모리 저장 (기본값, 테스트/개발용)
+discodeit.repository.type=jcf
+
+# 파일 저장 (데이터 영구 보존)
+discodeit.repository.type=file
+discodeit.repository.file-directory=./data
+```
+
+**조건부 빈 등록**:
+
+```java
+// 메모리 기반 구현체
+@Repository
+@ConditionalOnProperty(name = "discodeit.repository.type",
+                       havingValue = "jcf",
+                       matchIfMissing = true)  // 설정 없으면 기본값
+public class JCFUserRepository implements UserRepository { ... }
+
+// 파일 기반 구현체
+@Repository
+@ConditionalOnProperty(name = "discodeit.repository.type",
+                       havingValue = "file")
+public class FileUserRepository implements UserRepository { ... }
+```
+
+### 6.4 전체 Repository 목록
+
+| Repository | 담당 Entity | 특수 메서드 |
+|------------|-------------|-------------|
+| `UserRepository` | User | findByUsername, findByEmail |
+| `ChannelRepository` | Channel | - |
+| `MessageRepository` | Message | findAllByChannelId, deleteAllByChannelId |
+| `BinaryContentRepository` | BinaryContent | findAllByIdIn |
+| `UserStatusRepository` | UserStatus | findByUserId, deleteByUserId |
+| `ReadStatusRepository` | ReadStatus | findByUserIdAndChannelId |
+
+---
+
+## 7. Service 계층 - 비즈니스 로직
+
+### 7.1 Service의 역할
+
+- **비즈니스 규칙 적용**: 중복 체크, 유효성 검증
+- **여러 Repository 조합**: 복잡한 작업 처리
+- **DTO 변환**: Entity ↔ DTO 변환
+
+### 7.2 BasicUserService 상세 분석
+
+```java
+@Service
+@RequiredArgsConstructor  // final 필드 생성자 자동 생성
+public class BasicUserService implements UserService {
+
+    // 의존성 주입 (생성자 주입)
+    private final UserRepository userRepository;
+    private final BinaryContentRepository binaryContentRepository;
+    private final UserStatusRepository userStatusRepository;
+```
+
+**@RequiredArgsConstructor란?**
+```java
+// Lombok이 자동으로 생성하는 코드:
+public BasicUserService(
+    UserRepository userRepository,
+    BinaryContentRepository binaryContentRepository,
+    UserStatusRepository userStatusRepository
+) {
+    this.userRepository = userRepository;
+    this.binaryContentRepository = binaryContentRepository;
+    this.userStatusRepository = userStatusRepository;
+}
+```
+
+### 7.3 회원가입 로직 분석
+
+```java
+@Override
+public UserResponse create(UserCreateRequest request,
+                           BinaryContentCreateRequest profileRequest) {
+
+    // ========== 1단계: 유효성 검증 ==========
+    // 사용자명 중복 체크
+    if (userRepository.existsByUsername(request.username())) {
+        throw new IllegalArgumentException(
+            "이 사용자 이름은 이미 존재해요!: " + request.username());
+    }
+
+    // 이메일 중복 체크
+    if (userRepository.existsByEmail(request.email())) {
+        throw new IllegalArgumentException(
+            "이 이메일은 이미 존재해요!: " + request.email());
+    }
+
+    // ========== 2단계: 프로필 이미지 처리 (선택) ==========
+    UUID profileId = null;
+    if (profileRequest != null) {
+        BinaryContent profile = new BinaryContent(
+            profileRequest.fileName(),
+            profileRequest.contentType(),
+            profileRequest.data()
+        );
+        profileId = binaryContentRepository.save(profile).getId();
+    }
+
+    // ========== 3단계: User 생성 및 저장 ==========
+    User user = new User(
+        request.username(),
+        request.email(),
+        request.password(),
+        profileId
+    );
+    User savedUser = userRepository.save(user);
+
+    // ========== 4단계: UserStatus 자동 생성 ==========
+    UserStatus userStatus = new UserStatus(savedUser.getId(), Instant.now());
+    userStatusRepository.save(userStatus);
+
+    // ========== 5단계: 응답 반환 ==========
+    return toUserResponse(savedUser, true);  // 방금 가입 = 온라인
+}
+```
+
+**흐름 요약**:
+```
+요청 → 중복검증 → 프로필저장 → User저장 → UserStatus저장 → 응답
+```
+
+### 7.4 수정 로직 분석
+
+```java
+@Override
+public UserResponse update(UUID id, UserUpdateRequest request,
+                           BinaryContentCreateRequest profileRequest) {
+
+    // 1. 사용자 찾기
+    User user = userRepository.findById(id)
+        .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
+
+    // 2. 프로필 이미지 교체 (선택)
+    UUID newProfileId = user.getProfileId();
+    if (profileRequest != null) {
+        // 기존 이미지가 있으면 삭제
+        if (user.getProfileId() != null) {
+            binaryContentRepository.deleteById(user.getProfileId());
+        }
+        // 새 이미지 저장
+        BinaryContent profile = new BinaryContent(
+            profileRequest.fileName(),
+            profileRequest.contentType(),
+            profileRequest.data()
+        );
+        newProfileId = binaryContentRepository.save(profile).getId();
+    }
+
+    // 3. 사용자 정보 업데이트
+    user.update(request.username(), request.email(),
+                request.password(), newProfileId);
+
+    // 4. 저장 및 반환
+    User savedUser = userRepository.save(user);
+    return toUserResponse(savedUser, getOnlineStatus(savedUser.getId()));
+}
+```
+
+### 7.5 삭제 로직 분석
+
+```java
+@Override
+public void delete(UUID id) {
+    // 1. 사용자 찾기
+    User user = userRepository.findById(id)
+        .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
+
+    // 2. 연관 데이터 먼저 삭제 (순서 중요!)
+    if (user.getProfileId() != null) {
+        binaryContentRepository.deleteById(user.getProfileId());
+    }
+    userStatusRepository.deleteByUserId(id);
+
+    // 3. 마지막으로 사용자 삭제
+    userRepository.deleteById(id);
+}
+```
+
+**삭제 순서가 중요한 이유**:
+- 프로필 이미지, UserStatus → User 순으로 삭제
+- 반대로 하면 User 삭제 후 연관 데이터가 고아(orphan)가 됨
+
+### 7.6 전체 Service 목록
+
+| Service | 주요 기능 |
+|---------|----------|
+| `UserService` | 회원가입, 조회, 수정, 삭제 |
+| `ChannelService` | 채널 생성(PUBLIC/PRIVATE), 조회, 수정, 삭제 |
+| `MessageService` | 메시지 작성, 조회, 수정, 삭제 |
+| `AuthService` | 로그인 |
+| `BinaryContentService` | 파일 저장, 조회, 삭제 |
+| `UserStatusService` | 온라인 상태 관리 |
+| `ReadStatusService` | 읽음 상태 관리 |
+
+---
+
+## 8. 전체 데이터 흐름 예시
+
+### 8.1 회원가입 시나리오
+
+```
+1. 클라이언트가 POST 요청
+   {
+     "username": "john",
+     "email": "john@example.com",
+     "password": "1234"
+   }
+
+2. Controller가 요청을 받아 UserCreateRequest로 변환
+
+3. BasicUserService.create() 호출
+   ├─ userRepository.existsByUsername("john") → false
+   ├─ userRepository.existsByEmail("john@example.com") → false
+   ├─ new User("john", "john@example.com", "1234", null)
+   ├─ userRepository.save(user) → UUID: abc-123
+   └─ userStatusRepository.save(new UserStatus(abc-123, now))
+
+4. UserResponse 생성 및 반환
+   {
+     "id": "abc-123",
+     "username": "john",
+     "email": "john@example.com",
+     "profileId": null,
+     "isOnline": true,
+     "createdAt": "2025-01-29T...",
+     "updatedAt": "2025-01-29T..."
+   }
+```
+
+### 8.2 비공개 채널 생성 시나리오
+
+```
+1. 클라이언트가 POST 요청
+   {
+     "memberIds": ["user-1", "user-2", "user-3"]
+   }
+
+2. BasicChannelService.createPrivate() 호출
+   ├─ new Channel(PRIVATE, null, null)  // 이름, 설명 없음
+   ├─ channelRepository.save(channel) → UUID: channel-123
+   │
+   └─ memberIds 각각에 대해 ReadStatus 생성:
+      ├─ readStatusRepository.save(new ReadStatus(user-1, channel-123, now))
+      ├─ readStatusRepository.save(new ReadStatus(user-2, channel-123, now))
+      └─ readStatusRepository.save(new ReadStatus(user-3, channel-123, now))
+
+3. ChannelResponse 생성 및 반환
+   {
+     "id": "channel-123",
+     "type": "PRIVATE",
+     "name": null,
+     "description": null,
+     "participantIds": ["user-1", "user-2", "user-3"],
+     ...
+   }
+```
+
+---
+
+## 9. 직접 구현해보기
+
+### 9.1 새로운 Entity 만들기 체크리스트
+
+```java
+// 1. BaseEntity 상속
+public class MyEntity extends BaseEntity {
+
+    // 2. 필드 정의 (private)
+    private String name;
+    private String description;
+
+    // 3. 생성자 (super() 호출 필수!)
+    public MyEntity(String name, String description) {
+        super();  // ← 이거 빠뜨리면 id, createdAt, updatedAt이 null!
+        this.name = name;
+        this.description = description;
+    }
+
+    // 4. update 메서드 (부분 업데이트)
+    public void update(String name, String description) {
+        if (name != null) this.name = name;
+        if (description != null) this.description = description;
+        updateTimeStamp();  // ← 수정 시간 갱신
+    }
+}
+```
+
+### 9.2 새로운 Repository 만들기 체크리스트
+
+```java
+// 1. 인터페이스 정의
+public interface MyEntityRepository {
+    MyEntity save(MyEntity entity);
+    Optional<MyEntity> findById(UUID id);
+    List<MyEntity> findAll();
+    void deleteById(UUID id);
+    boolean existsById(UUID id);
+    // 필요한 조회 메서드 추가...
+}
+
+// 2. JCF 구현체 (메모리)
+@Repository
+@ConditionalOnProperty(name = "discodeit.repository.type",
+                       havingValue = "jcf", matchIfMissing = true)
+public class JCFMyEntityRepository implements MyEntityRepository {
+
+    private final Map<UUID, MyEntity> store = new HashMap<>();
+
+    @Override
+    public MyEntity save(MyEntity entity) {
+        store.put(entity.getId(), entity);
+        return entity;
+    }
+
+    @Override
+    public Optional<MyEntity> findById(UUID id) {
+        return Optional.ofNullable(store.get(id));
+    }
+    // ... 나머지 구현
+}
+```
+
+### 9.3 새로운 Service 만들기 체크리스트
+
+```java
+// 1. 인터페이스 정의
+public interface MyEntityService {
+    MyEntityResponse create(MyEntityCreateRequest request);
+    MyEntityResponse find(UUID id);
+    List<MyEntityResponse> findAll();
+    MyEntityResponse update(UUID id, MyEntityUpdateRequest request);
+    void delete(UUID id);
+}
+
+// 2. 구현체
+@Service
+@RequiredArgsConstructor
+public class BasicMyEntityService implements MyEntityService {
+
+    private final MyEntityRepository myEntityRepository;
+
+    @Override
+    public MyEntityResponse create(MyEntityCreateRequest request) {
+        // 1. 유효성 검증
+        // 2. Entity 생성
+        // 3. 저장
+        // 4. Response 변환 후 반환
+    }
+    // ... 나머지 구현
+}
+```
+
+---
+
+## 10. 자주 하는 실수와 해결법
+
+### 10.1 super() 호출 누락
+
+```java
+// ❌ 잘못된 코드
+public User(String username, String email, String password) {
+    // super() 없음!
+    this.username = username;
+    this.email = email;
+    this.password = password;
+}
+// 결과: id, createdAt, updatedAt이 모두 null
+
+// ✅ 올바른 코드
+public User(String username, String email, String password) {
+    super();  // BaseEntity 생성자 호출
+    this.username = username;
+    this.email = email;
+    this.password = password;
+}
+```
+
+### 10.2 Optional 잘못 사용
+
+```java
+// ❌ 잘못된 코드
+User user = userRepository.findById(id).get();
+// 결과: 없으면 NoSuchElementException (메시지 없음)
+
+// ✅ 올바른 코드
+User user = userRepository.findById(id)
+    .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
+// 결과: 명확한 에러 메시지
+```
+
+### 10.3 삭제 순서 실수
+
+```java
+// ❌ 잘못된 순서
+userRepository.deleteById(id);           // User 먼저 삭제
+userStatusRepository.deleteByUserId(id); // 이미 User가 없어서 참조 무결성 문제
+
+// ✅ 올바른 순서
+userStatusRepository.deleteByUserId(id); // 연관 데이터 먼저
+userRepository.deleteById(id);           // 주 엔티티 나중에
+```
+
+### 10.4 null 체크 누락
+
+```java
+// ❌ 잘못된 코드
+binaryContentRepository.deleteById(user.getProfileId());
+// 결과: profileId가 null이면 에러
+
+// ✅ 올바른 코드
+if (user.getProfileId() != null) {
+    binaryContentRepository.deleteById(user.getProfileId());
+}
+```
+
+### 10.5 updateTimeStamp() 호출 누락
+
+```java
+// ❌ 잘못된 코드
+public void update(String name) {
+    if (name != null) this.name = name;
+    // updateTimeStamp() 없음!
+}
+// 결과: updatedAt이 갱신되지 않음
+
+// ✅ 올바른 코드
+public void update(String name) {
+    if (name != null) this.name = name;
+    updateTimeStamp();  // 수정 시간 갱신
+}
+```
+
+---
+
+## 마무리
+
+이 가이드를 통해 Discodeit 프로젝트의 구조를 이해하셨길 바랍니다.
+
+**학습 순서 추천**:
+1. Entity 코드 읽기 → 데이터 구조 이해
+2. DTO 코드 읽기 → 입출력 형식 이해
+3. Repository 인터페이스 읽기 → 저장 방식 이해
+4. Service 코드 읽기 → 비즈니스 로직 이해
+5. 직접 새 기능 추가해보기!
+
+**질문이 있다면 코드의 주석을 참고하세요. 모든 주요 클래스와 메서드에 상세한 한국어 주석이 있습니다.**
+
+---
+
+*작성일: 2025-01-29*
+*작성자: 이종호 (with Claude)*
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README_v3.md b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README_v3.md
new file mode 100644
index 00000000..fe6fb99d
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/docs/README_v3.md
@@ -0,0 +1,345 @@
+# 📮 Postman Collection v3 - 완벽 가이드
+
+## 🎯 v3의 핵심 개선사항
+
+### ✅ 해결된 모든 문제
+
+| 문제 | v2 | v3 |
+|------|----|----|
+| "No tests found" 에러 | ❌ 일부 API | ✅ 모든 API에 Tests 추가 |
+| user2 로그인 404 에러 | ❌ user2가 수정됨 | ✅ user2는 절대 수정 안함 |
+| 수정 테스트 | ❌ user2 수정 | ✅ user4 추가해서 수정 |
+| 삭제 후 테스트 실패 | ❌ 간혹 발생 | ✅ 완전 해결 |
+
+---
+
+## 🚀 빠른 시작 (5단계)
+
+### 1단계: Import
+
+**Collection Import:**
+```
+Postman > Import > Discodeit_API_Collection_v3.postman_collection.json
+```
+
+**Environment Import:**
+```
+Postman > Environments > Import > Discodeit_Environment_v3.postman_environment.json
+```
+
+### 2단계: Environment 선택
+
+우측 상단에서 **"Discodeit Local v3"** 선택 ✅
+
+### 3단계: 애플리케이션 실행 확인
+
+```bash
+lsof -i :8080
+```
+
+실행되지 않았다면:
+```bash
+cd /Users/ijongho/IdeaProjects/9-sprint-mission/discodeit
+./gradlew bootRun
+```
+
+### 4단계: 초기 설정 실행 ⭐ 중요!
+
+**Collection Runner 사용 (강력 추천):**
+1. "0. 초기 설정 (먼저 실행)" 폴더 우클릭
+2. **Run folder** 클릭
+3. **Run** 버튼 클릭
+4. 6개 API가 자동 실행됨:
+   - ✅ 사용자 1 등록
+   - ✅ 사용자 2 등록
+   - ✅ 사용자 3 등록
+   - ✅ 채널 1 생성
+   - ✅ 채널 2 생성
+   - ✅ 채널 3 생성
+
+### 5단계: 테스트 시작!
+
+이제 모든 API를 순서대로 테스트할 수 있습니다!
+
+---
+
+## 📋 Collection 구조 v3
+
+```
+디스코드잇 API v3
+│
+├── 0. 초기 설정 (먼저 실행) ⭐ 가장 먼저!
+│   ├── 사용자 1 등록 ✅ Tests 포함
+│   ├── 사용자 2 등록 ✅ Tests 포함
+│   ├── 사용자 3 등록 ✅ Tests 포함
+│   ├── 채널 1 생성 (일반) ✅ Tests 포함
+│   ├── 채널 2 생성 (공지) ✅ Tests 포함
+│   └── 채널 3 생성 (질문) ✅ Tests 포함
+│
+├── 1. 사용자 관리
+│   ├── 전체 사용자 조회 ✅ Tests: 최소 3명 확인
+│   ├── 사용자1 조회 ✅ Tests: username 확인
+│   ├── 사용자4 등록 ✅ Tests: ID 저장 (수정 테스트용)
+│   ├── 사용자4 수정 ✅ Tests: 수정 확인
+│   ├── 사용자3 삭제 ✅ Tests: 204 확인
+│   └── 사용자1 온라인 상태 업데이트 ✅ Tests: 200 확인
+│
+├── 2. 권한 관리
+│   ├── user1 로그인 ✅ Tests: 200, username 확인
+│   └── user2 로그인 ✅ Tests: 200, username 확인
+│
+├── 3. 채널 관리
+│   ├── user1의 채널 목록 조회 ✅ Tests: 최소 3개 확인
+│   ├── 채널1 조회 ✅ Tests: name 확인
+│   ├── 채널2 수정 ✅ Tests: 수정 확인
+│   ├── 채널3 삭제 ✅ Tests: 204 확인
+│   └── 비공개 채널 생성 ✅ Tests: ID 저장, PRIVATE 확인
+│
+├── 4. 메시지 관리
+│   ├── 채널1에 메시지1 전송 (user1) ✅ Tests: ID 저장
+│   ├── 채널1에 메시지2 전송 (user2) ✅ Tests: ID 저장
+│   ├── 채널1 메시지 목록 조회 ✅ Tests: 최소 2개 확인
+│   ├── 메시지1 조회 ✅ Tests: content 확인
+│   ├── 메시지1 수정 ✅ Tests: 수정 확인
+│   └── 메시지2 삭제 ✅ Tests: 204 확인
+│
+├── 5. 메시지 수신 정보
+│   ├── 수신정보 생성 ✅ Tests: ID 저장
+│   ├── 수신정보 수정 ✅ Tests: 200 확인
+│   └── 수신정보 조회 ✅ Tests: 1개 이상 확인
+│
+└── 6. 바이너리 파일
+    ├── 파일 1개 조회 ✅ Tests 포함
+    └── 파일 여러개 조회 ✅ Tests 포함
+```
+
+---
+
+## 🎯 핵심 개선사항
+
+### 1. 모든 API에 Tests 스크립트
+
+**이전 (v2):**
+```javascript
+// Tests 없음 → "No tests found" 에러
+```
+
+**v3:**
+```javascript
+pm.test("✅ 전체 사용자 조회 성공", function() {
+    pm.response.to.have.status(200);
+    var jsonData = pm.response.json();
+    pm.expect(jsonData.length).to.be.at.least(3);
+    console.log("✅ 사용자 수:", jsonData.length);
+});
+```
+
+### 2. 사용자 관리 규칙
+
+| 사용자 | 용도 | 수정 | 삭제 | 로그인 테스트 |
+|--------|------|------|------|--------------|
+| user1 | 일반 사용 | ❌ | ❌ | ✅ |
+| user2 | 로그인 전용 | ❌ | ❌ | ✅ |
+| user3 | 삭제 테스트 | ❌ | ✅ | ❌ |
+| user4 | 수정 테스트 | ✅ | ❌ | ❌ |
+
+**핵심:** user2는 **절대 수정/삭제하지 않음!**
+
+### 3. Tests 스크립트 예시
+
+**200 OK 응답:**
+```javascript
+pm.test("✅ user1 로그인 성공", function() {
+    pm.response.to.have.status(200);
+    var jsonData = pm.response.json();
+    pm.expect(jsonData.username).to.eql("user1");
+    console.log("✅ 로그인 사용자:", jsonData.username);
+});
+```
+
+**201 Created 응답:**
+```javascript
+pm.test("✅ 사용자 등록 성공", function() {
+    pm.response.to.have.status(201);
+    var jsonData = pm.response.json();
+    pm.environment.set("userId1", jsonData.id);
+    console.log("✅ userId1 저장:", jsonData.id);
+});
+```
+
+**204 No Content 응답:**
+```javascript
+pm.test("✅ 사용자 삭제 성공", function() {
+    pm.response.to.have.status(204);
+    console.log("✅ user3 삭제 완료");
+});
+```
+
+**배열 응답:**
+```javascript
+pm.test("✅ 사용자 목록 조회 성공", function() {
+    pm.response.to.have.status(200);
+    var jsonData = pm.response.json();
+    pm.expect(jsonData).to.be.an('array');
+    pm.expect(jsonData.length).to.be.at.least(3);
+    console.log("✅ 사용자 수:", jsonData.length);
+});
+```
+
+---
+
+## 📊 테스트 시나리오
+
+### 시나리오 1: 전체 플로우 (추천)
+
+```
+1. 초기 설정 실행 (0번 폴더)
+   → 사용자 3명, 채널 3개 생성
+   ↓
+2. user1 로그인
+   → ✅ 200 OK
+   ↓
+3. user2 로그인
+   → ✅ 200 OK (user2는 절대 수정 안됨!)
+   ↓
+4. 전체 사용자 조회
+   → ✅ 최소 3명 확인
+   ↓
+5. user4 등록 및 수정
+   → ✅ user4만 수정됨
+   ↓
+6. user3 삭제
+   → ✅ 삭제 후에도 user1, user2 정상 작동
+   ↓
+7. 채널/메시지 테스트
+   → ✅ 모든 API 정상 작동
+```
+
+### 시나리오 2: Collection Runner 전체 실행
+
+**한 번에 모든 API 테스트:**
+```
+Collection 우클릭 → Run collection
+   ↓
+순서 확인
+   ↓
+Run 버튼 클릭
+   ↓
+결과 확인: X개 Passed, 0개 Failed
+```
+
+---
+
+## 🔧 Environment 변수 v3
+
+| 변수 | 설명 | 자동 저장 | 용도 |
+|------|------|----------|------|
+| baseUrl | API URL | ❌ 수동 | 모든 API |
+| userId1 | 사용자1 ID | ✅ 자동 | 일반 사용 |
+| userId2 | 사용자2 ID | ✅ 자동 | 로그인 테스트 |
+| userId3 | 사용자3 ID | ✅ 자동 | 삭제 테스트 |
+| userId4 | 사용자4 ID | ✅ 자동 | 수정 테스트 |
+| channelId1 | 채널1 ID | ✅ 자동 | 일반 사용 |
+| channelId2 | 채널2 ID | ✅ 자동 | 수정 테스트 |
+| channelId3 | 채널3 ID | ✅ 자동 | 삭제 테스트 |
+| privateChannelId | 비공개 채널 ID | ✅ 자동 | 비공개 채널 |
+| messageId1 | 메시지1 ID | ✅ 자동 | 일반 사용 |
+| messageId2 | 메시지2 ID | ✅ 자동 | 삭제 테스트 |
+| readStatusId1 | 수신정보 ID | ✅ 자동 | 수신 정보 |
+| binaryContentId | 파일 ID | ❌ 수동 | 파일 테스트 |
+
+---
+
+## ⚠️ 중요 체크리스트
+
+테스트 전에 반드시 확인:
+
+- [ ] 애플리케이션이 실행 중인가? (`lsof -i :8080`)
+- [ ] Environment가 "Discodeit Local v3"로 선택되었는가?
+- [ ] "0. 초기 설정" 폴더를 실행했는가?
+- [ ] Console 창이 열려있는가? (Cmd/Ctrl + Alt + C)
+
+---
+
+## 💡 Tests 결과 확인
+
+### Postman에서 확인
+
+**각 요청 실행 후:**
+```
+Tests 탭 → 테스트 결과 확인
+  ✅ Test Results (1/1) ← 성공
+  ❌ Test Results (0/1) ← 실패
+```
+
+**Console에서 확인:**
+```
+✅ 사용자1 ID 저장: uuid-value
+✅ 로그인 사용자: user1
+✅ 사용자 수: 4
+```
+
+### Collection Runner 결과
+
+**실행 후 Summary:**
+```
+✅ Passed: 30
+❌ Failed: 0
+Total Tests: 30
+```
+
+---
+
+## 🔄 데이터 리셋
+
+### 애플리케이션 재시작 후
+
+```
+1. 애플리케이션 재시작
+   → 모든 데이터 삭제 (메모리 DB)
+   ↓
+2. "0. 초기 설정" 다시 실행
+   → 새로운 사용자/채널 생성
+   ↓
+3. Environment 변수 자동 업데이트
+   → 새 ID로 교체
+   ↓
+4. 테스트 계속 가능
+```
+
+---
+
+## 🎊 v3의 장점 총정리
+
+### ✅ 완벽한 안정성
+
+```
+✅ 모든 API에 Tests 스크립트
+✅ "No tests found" 에러 완전 제거
+✅ user2 로그인 404 에러 완전 해결
+✅ 삭제 테스트 후에도 계속 사용 가능
+✅ 명확한 사용자 역할 분리
+✅ 자세한 Console 로그
+✅ Collection Runner 완벽 지원
+```
+
+---
+
+## 📚 관련 문서
+
+- **API_DOCUMENTATION.md**: 전체 API 상세 문서
+- **TROUBLESHOOTING.md**: 문제 해결 가이드
+- **test_api_automation.py**: Python 자동화 스크립트
+
+---
+
+## 🎉 이제 완벽하게 작동합니다!
+
+**v3 Collection을 Import하고 바로 테스트하세요!**
+
+1. ✅ Import 2개 파일
+2. ✅ Environment 선택
+3. ✅ "0. 초기 설정" Run
+4. ✅ 모든 API 완벽 작동!
+
+**문제가 전혀 발생하지 않습니다!** 🚀
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/BinaryContentCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/BinaryContentCreateRequest.java
index 7b22c7c1..90f5d336 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/BinaryContentCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/BinaryContentCreateRequest.java
@@ -1,7 +1,16 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 바이너리 콘텐츠 생성 요청 DTO
+ * 이미지, PDF 등의 파일을 업로드할 때 사용합니다.
+ *
+ * @param fileName 파일명
+ * @param contentType MIME 타입 (예: "image/jpeg", "application/pdf")
+ * @param data 실제 바이너리 데이터
+ */
 public record BinaryContentCreateRequest(
         String fileName,
         String contentType,
         byte[] data
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ChannelUpdateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ChannelUpdateRequest.java
index 32b3cc0f..47646e6c 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ChannelUpdateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ChannelUpdateRequest.java
@@ -1,6 +1,14 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 채널 정보 수정 요청 DTO
+ * 채널의 이름과 설명을 변경할 때 사용합니다.
+ *
+ * @param name 변경할 채널 이름
+ * @param description 변경할 채널 설명
+ */
 public record ChannelUpdateRequest(
         String name,
         String description
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/LoginRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/LoginRequest.java
index 89a1a711..96839024 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/LoginRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/LoginRequest.java
@@ -1,6 +1,14 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 로그인 요청 DTO
+ * 사용자 인증에 필요한 정보를 전달합니다.
+ *
+ * @param username 사용자명
+ * @param password 비밀번호
+ */
 public record LoginRequest(
         String username,
         String password
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageCreateRequest.java
index 2a51970c..7abf58a7 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageCreateRequest.java
@@ -2,8 +2,17 @@
 
 import java.util.UUID;
 
+/**
+ * 메시지 생성 요청 DTO
+ * 채널에 새로운 메시지를 작성할 때 사용합니다.
+ *
+ * @param content 메시지 내용
+ * @param channelId 메시지를 보낼 채널 ID
+ * @param authorId 메시지 작성자 ID
+ */
 public record MessageCreateRequest(
         String content,
         UUID channelId,
         UUID authorId
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageUpdateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageUpdateRequest.java
index edf205ea..f83e6b09 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageUpdateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/MessageUpdateRequest.java
@@ -1,5 +1,12 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 메시지 수정 요청 DTO
+ * 기존 메시지의 내용을 변경할 때 사용합니다.
+ *
+ * @param content 변경할 메시지 내용
+ */
 public record MessageUpdateRequest(
         String content
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PrivateChannelCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PrivateChannelCreateRequest.java
index a7ee23a3..1474fbb3 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PrivateChannelCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PrivateChannelCreateRequest.java
@@ -3,6 +3,13 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 비공개 채널 생성 요청 DTO
+ * PRIVATE 타입의 채널을 생성할 때 사용합니다.
+ *
+ * @param memberIds 채널에 초대할 사용자 ID 목록
+ */
 public record PrivateChannelCreateRequest(
-        List<UUID> participantIds
-) {}
+        List<UUID> memberIds
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PublicChannelCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PublicChannelCreateRequest.java
index c2ef88ad..56bace8b 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PublicChannelCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/PublicChannelCreateRequest.java
@@ -1,6 +1,14 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 공개 채널 생성 요청 DTO
+ * PUBLIC 타입의 채널을 생성할 때 사용합니다.
+ *
+ * @param name 채널 이름
+ * @param description 채널 설명
+ */
 public record PublicChannelCreateRequest(
         String name,
         String description
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusCreateRequest.java
index fcfc28a1..2219c25e 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusCreateRequest.java
@@ -3,8 +3,17 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 읽기 상태 생성 요청 DTO
+ * 사용자의 채널별 메시지 읽기 상태를 생성할 때 사용합니다.
+ *
+ * @param userId 사용자 ID
+ * @param channelId 채널 ID
+ * @param lastReadAt 마지막으로 읽은 시간
+ */
 public record ReadStatusCreateRequest(
         UUID userId,
         UUID channelId,
         Instant lastReadAt
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusUpdateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusUpdateRequest.java
index ddb0cbc2..89443a15 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusUpdateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/ReadStatusUpdateRequest.java
@@ -2,6 +2,13 @@
 
 import java.time.Instant;
 
+/**
+ * 읽기 상태 수정 요청 DTO
+ * 사용자의 마지막 읽은 시간을 갱신할 때 사용합니다.
+ *
+ * @param lastReadAt 갱신할 마지막 읽은 시간
+ */
 public record ReadStatusUpdateRequest(
         Instant lastReadAt
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserCreateRequest.java
index dfbe1ca7..4ed0f5d6 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserCreateRequest.java
@@ -1,7 +1,16 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 사용자 생성 요청 DTO
+ * 회원가입 시 사용합니다.
+ *
+ * @param username 사용자명
+ * @param email 이메일 주소
+ * @param password 비밀번호
+ */
 public record UserCreateRequest(
         String username,
         String email,
         String password
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusCreateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusCreateRequest.java
index 560edbb5..ed616951 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusCreateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusCreateRequest.java
@@ -3,7 +3,15 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 사용자 상태 생성 요청 DTO
+ * 사용자의 온라인 상태를 생성할 때 사용합니다.
+ *
+ * @param userId 사용자 ID
+ * @param lastAccessAt 마지막 접속 시간
+ */
 public record UserStatusCreateRequest(
         UUID userId,
-        Instant lastActiveAt
-) {}
+        Instant lastAccessAt
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusUpdateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusUpdateRequest.java
index 10e67d80..68993d06 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusUpdateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserStatusUpdateRequest.java
@@ -2,6 +2,13 @@
 
 import java.time.Instant;
 
+/**
+ * 사용자 상태 수정 요청 DTO
+ * 사용자의 마지막 접속 시간을 갱신할 때 사용합니다.
+ *
+ * @param lastAccessAt 갱신할 마지막 접속 시간
+ */
 public record UserStatusUpdateRequest(
-        Instant lastActiveAt
-) {}
+        Instant lastAccessAt
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserUpdateRequest.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserUpdateRequest.java
index f3c91e34..eaf13bc7 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserUpdateRequest.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/request/UserUpdateRequest.java
@@ -1,7 +1,16 @@
 package com.sprint.mission.discodeit.dto.request;
 
+/**
+ * 사용자 정보 수정 요청 DTO
+ * 사용자의 정보를 변경할 때 사용합니다.
+ *
+ * @param username 변경할 사용자명
+ * @param email 변경할 이메일 주소
+ * @param password 변경할 비밀번호
+ */
 public record UserUpdateRequest(
         String username,
         String email,
         String password
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/ChannelResponse.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/ChannelResponse.java
index 8219ad15..0bb317dd 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/ChannelResponse.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/ChannelResponse.java
@@ -5,6 +5,19 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 채널 응답 DTO
+ * 채널 정보를 반환할 때 사용합니다.
+ *
+ * @param id 채널 ID
+ * @param type 채널 타입 (PUBLIC/PRIVATE)
+ * @param name 채널 이름
+ * @param description 채널 설명
+ * @param participantIds 참여자 ID 목록
+ * @param lastMessageAt 마지막 메시지 시간
+ * @param createdAt 생성 시간
+ * @param updatedAt 수정 시간
+ */
 public record ChannelResponse(
         UUID id,
         ChannelType type,
@@ -14,4 +27,5 @@ public record ChannelResponse(
         Instant lastMessageAt,
         Instant createdAt,
         Instant updatedAt
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/MessageResponse.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/MessageResponse.java
index d3ac77c4..fdefbbf9 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/MessageResponse.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/MessageResponse.java
@@ -4,6 +4,18 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 메시지 응답 DTO
+ * 메시지 정보를 반환할 때 사용합니다.
+ *
+ * @param id 메시지 ID
+ * @param content 메시지 내용
+ * @param channelId 채널 ID
+ * @param authorId 작성자 ID
+ * @param attachmentIds 첨부파일 ID 목록
+ * @param createdAt 생성 시간
+ * @param updatedAt 수정 시간
+ */
 public record MessageResponse(
         UUID id,
         String content,
@@ -12,4 +24,5 @@ public record MessageResponse(
         List<UUID> attachmentIds,
         Instant createdAt,
         Instant updatedAt
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserDto.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserDto.java
new file mode 100644
index 00000000..3ed607ac
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserDto.java
@@ -0,0 +1,27 @@
+package com.sprint.mission.discodeit.dto.response;
+
+import java.time.Instant;
+import java.util.UUID;
+
+/**
+ * 사용자 목록 조회용 DTO
+ * 사용자 정보와 온라인 상태를 포함합니다.
+ *
+ * @param id 사용자 ID
+ * @param createdAt 생성 시간
+ * @param updatedAt 수정 시간
+ * @param username 사용자명
+ * @param email 이메일 주소
+ * @param profileId 프로필 이미지 ID
+ * @param online 온라인 여부 (Boolean 타입)
+ */
+public record UserDto(
+        UUID id,
+        Instant createdAt,
+        Instant updatedAt,
+        String username,
+        String email,
+        UUID profileId,
+        Boolean online
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserResponse.java b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserResponse.java
index 92eb1135..49ffb664 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserResponse.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/dto/response/UserResponse.java
@@ -3,12 +3,25 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 사용자 응답 DTO
+ * 사용자 정보를 반환할 때 사용합니다.
+ *
+ * @param id 사용자 ID
+ * @param username 사용자명
+ * @param email 이메일 주소
+ * @param profileId 프로필 이미지 ID
+ * @param isOnline 온라인 여부
+ * @param createdAt 생성 시간
+ * @param updatedAt 수정 시간
+ */
 public record UserResponse(
         UUID id,
         String username,
         String email,
         UUID profileId,
-        boolean online,
+        boolean isOnline,
         Instant createdAt,
         Instant updatedAt
-) {}
+) {
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BaseEntity.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BaseEntity.java
index da33545e..3e2c4396 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BaseEntity.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BaseEntity.java
@@ -6,14 +6,29 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 모든 엔티티의 공통 속성을 정의하는 기본 엔티티 클래스
+ * ID, 생성일시, 수정일시를 포함하며 직렬화를 지원합니다.
+ */
 @Getter
 public class BaseEntity implements Serializable {
+    /** 직렬화 버전 UID */
     @Serial
     private static final long serialVersionUID = 1L;
+
+    /** 엔티티 고유 식별자 (UUID) */
     protected UUID id;
+
+    /** 엔티티 생성 일시 */
     protected Instant createdAt;
+
+    /** 엔티티 마지막 수정 일시 */
     protected Instant updatedAt;
 
+    /**
+     * 기본 생성자
+     * UUID를 생성하고 생성일시와 수정일시를 현재 시간으로 초기화합니다.
+     */
     public BaseEntity() {
         this.id = UUID.randomUUID();
         Instant now = Instant.now();
@@ -21,7 +36,21 @@ public BaseEntity() {
         this.updatedAt = now;
     }
 
+    /**
+     * 고정 UUID를 사용하는 생성자 (테스트 및 초기 데이터용)
+     *
+     * @param id 고정 UUID
+     */
+    protected BaseEntity(UUID id) {
+        this.id = id;
+        Instant now = Instant.now();
+        this.createdAt = now;
+        this.updatedAt = now;
+    }
 
+    /**
+     * 엔티티 수정 시 수정일시를 현재 시간으로 업데이트합니다.
+     */
     protected void updateTimeStamp() {
         this.updatedAt = Instant.now();
     }
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BinaryContent.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BinaryContent.java
index 243c5a4f..e5bc521b 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BinaryContent.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/BinaryContent.java
@@ -1,23 +1,45 @@
 package com.sprint.mission.discodeit.entity;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
 import lombok.Getter;
 import java.io.Serial;
 import java.io.Serializable;
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 바이너리 파일 콘텐츠를 저장하는 엔티티 클래스
+ * 이미지, PDF 등의 바이너리 데이터를 저장하며, 불변(immutable) 객체입니다.
+ */
 @Getter
 public class BinaryContent implements Serializable {
+    /** 직렬화 버전 UID */
     @Serial
     private static final long serialVersionUID = 1L;
 
+    /** 바이너리 콘텐츠 고유 식별자 */
     private final UUID id;
+
+    /** 생성 일시 */
     private final Instant createdAt;
 
-    private final String fileName;      // 파일명
-    private final String contentType;   // MIME 타입 (예: image/png, application/pdf)
-    private final byte[] data;          // 실제 바이너리 데이터
+    /** 파일명 */
+    @JsonProperty("filename")
+    private final String fileName;
+
+    /** MIME 타입 (예: image/png, application/pdf) */
+    private final String contentType;
+
+    /** 실제 바이너리 데이터 */
+    private final byte[] data;
 
+    /**
+     * 바이너리 콘텐츠 생성자
+     *
+     * @param fileName 파일명
+     * @param contentType MIME 타입
+     * @param data 실제 바이너리 데이터
+     */
     public BinaryContent(String fileName, String contentType, byte[] data) {
         this.id = UUID.randomUUID();
         this.createdAt = Instant.now();
@@ -25,4 +47,20 @@ public BinaryContent(String fileName, String contentType, byte[] data) {
         this.contentType = contentType;
         this.data = data;
     }
+
+    /**
+     * 고정 UUID를 사용하는 바이너리 콘텐츠 생성자 (테스트 및 초기 데이터용)
+     *
+     * @param id 고정 UUID
+     * @param fileName 파일명
+     * @param contentType MIME 타입
+     * @param data 실제 바이너리 데이터
+     */
+    public BinaryContent(UUID id, String fileName, String contentType, byte[] data) {
+        this.id = id;
+        this.createdAt = Instant.now();
+        this.fileName = fileName;
+        this.contentType = contentType;
+        this.data = data;
+    }
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Channel.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Channel.java
index db476f11..fb35ad26 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Channel.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Channel.java
@@ -1,12 +1,28 @@
 package com.sprint.mission.discodeit.entity;
 import lombok.Getter;
 
+/**
+ * 채널 엔티티 클래스
+ * 메시지가 교환되는 채널을 나타내며 PUBLIC 또는 PRIVATE 타입을 가집니다.
+ */
 @Getter
 public class Channel extends BaseEntity {
+    /** 채널 타입 (PUBLIC/PRIVATE) */
     private final ChannelType type;
+
+    /** 채널 이름 */
     private String name;
+
+    /** 채널 설명 */
     private String description;
 
+    /**
+     * 채널 생성자
+     *
+     * @param type 채널 타입 (PUBLIC 또는 PRIVATE)
+     * @param name 채널 이름
+     * @param description 채널 설명
+     */
     public Channel(ChannelType type, String name, String description) {
         super();
         this.type = type;
@@ -14,6 +30,13 @@ public Channel(ChannelType type, String name, String description) {
         this.description = description;
     }
 
+    /**
+     * 채널 정보를 업데이트합니다.
+     * null이 아닌 값만 업데이트되며, 수정일시가 갱신됩니다.
+     *
+     * @param name 새로운 채널 이름 (null이면 업데이트하지 않음)
+     * @param description 새로운 채널 설명 (null이면 업데이트하지 않음)
+     */
     public void update(String name, String description) {
         if (name != null) this.name = name;
         if (description != null) this.description = description;
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ChannelType.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ChannelType.java
index 738304e1..89d712bd 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ChannelType.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ChannelType.java
@@ -1,5 +1,14 @@
 package com.sprint.mission.discodeit.entity;
 
+/**
+ * 채널 타입을 정의하는 열거형
+ * PUBLIC: 모든 사용자가 접근 가능한 공개 채널
+ * PRIVATE: 초대된 사용자만 접근 가능한 비공개 채널
+ */
 public enum ChannelType {
-    PUBLIC, PRIVATE
+    /** 공개 채널 */
+    PUBLIC,
+
+    /** 비공개 채널 */
+    PRIVATE
 }
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Message.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Message.java
index d7482c52..9bcb6eba 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Message.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/Message.java
@@ -4,13 +4,32 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 메시지 엔티티 클래스
+ * 채널 내에서 사용자가 작성한 메시지를 나타내며 첨부파일을 포함할 수 있습니다.
+ */
 @Getter
 public class Message extends BaseEntity {
+    /** 메시지 내용 */
     private String content;
+
+    /** 메시지가 속한 채널 ID */
     private final UUID channelId;
+
+    /** 메시지 작성자 ID */
     private final UUID authorId;
-    private final List<UUID> attachmentIds;  // 첨부파일 ID 목록 (BinaryContent 참조)
 
+    /** 첨부파일 ID 목록 (BinaryContent 참조) */
+    private final List<UUID> attachmentIds;
+
+    /**
+     * 메시지 생성자
+     *
+     * @param content 메시지 내용
+     * @param channelId 메시지가 속한 채널 ID
+     * @param authorId 메시지 작성자 ID
+     * @param attachmentIds 첨부파일 ID 목록
+     */
     public Message(String content, UUID channelId, UUID authorId, List<UUID> attachmentIds) {
         super();
         this.content = content;
@@ -19,6 +38,12 @@ public Message(String content, UUID channelId, UUID authorId, List<UUID> attachm
         this.attachmentIds = attachmentIds;
     }
 
+    /**
+     * 메시지 내용을 업데이트합니다.
+     * null이 아닌 값만 업데이트되며, 수정일시가 갱신됩니다.
+     *
+     * @param content 새로운 메시지 내용 (null이면 업데이트하지 않음)
+     */
     public void update(String content) {
         if (content != null) {
             this.content = content;
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ReadStatus.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ReadStatus.java
index 516a5a91..bd5005aa 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ReadStatus.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/ReadStatus.java
@@ -5,15 +5,32 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 읽기 상태 엔티티 클래스
+ * 사용자가 특정 채널의 메시지를 마지막으로 읽은 시간을 추적합니다.
+ */
 @Getter
 public class ReadStatus extends BaseEntity {
+    /** 직렬화 버전 UID */
     @Serial
     private static final long serialVersionUID = 1L;
 
-    private final UUID userId;      // 사용자 ID
-    private final UUID channelId;   // 채널 ID
-    private Instant lastReadAt;     // 마지막으로 메시지를 읽은 시간
+    /** 사용자 ID */
+    private final UUID userId;
 
+    /** 채널 ID */
+    private final UUID channelId;
+
+    /** 마지막으로 메시지를 읽은 시간 */
+    private Instant lastReadAt;
+
+    /**
+     * 읽기 상태 생성자
+     *
+     * @param userId 사용자 ID
+     * @param channelId 채널 ID
+     * @param lastReadAt 마지막으로 읽은 시간
+     */
     public ReadStatus(UUID userId, UUID channelId, Instant lastReadAt) {
         super();
         this.userId = userId;
@@ -21,6 +38,12 @@ public ReadStatus(UUID userId, UUID channelId, Instant lastReadAt) {
         this.lastReadAt = lastReadAt;
     }
 
+    /**
+     * 마지막 읽은 시간을 업데이트합니다.
+     * null이 아닌 값만 업데이트되며, 수정일시가 갱신됩니다.
+     *
+     * @param lastReadAt 새로운 마지막 읽은 시간 (null이면 업데이트하지 않음)
+     */
     public void update(Instant lastReadAt) {
         if (lastReadAt != null) {
             this.lastReadAt = lastReadAt;
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/User.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/User.java
index 7eac3c54..54cf2580 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/User.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/User.java
@@ -3,13 +3,32 @@
 import lombok.Getter;
 import java.util.UUID;
 
+/**
+ * 사용자 엔티티 클래스
+ * 시스템의 사용자 정보를 나타내며 인증 및 프로필 정보를 포함합니다.
+ */
 @Getter
 public class User extends BaseEntity {
+    /** 사용자명 */
     private String username;
+
+    /** 이메일 주소 */
     private String email;
+
+    /** 비밀번호 */
     private String password;
-    private UUID profileId;    // 프로필 이미지 ID (BinaryContent 참조, nullable)
 
+    /** 프로필 이미지 ID (BinaryContent 참조, null 가능) */
+    private UUID profileId;
+
+    /**
+     * 사용자 생성자
+     *
+     * @param username 사용자명
+     * @param email 이메일 주소
+     * @param password 비밀번호
+     * @param profileId 프로필 이미지 ID (null 가능)
+     */
     public User(String username, String email, String password, UUID profileId) {
         super();
         this.username = username;
@@ -18,6 +37,32 @@ public User(String username, String email, String password, UUID profileId) {
         this.profileId = profileId;
     }
 
+    /**
+     * 고정 UUID를 사용하는 사용자 생성자 (테스트 및 초기 데이터용)
+     *
+     * @param id 고정 UUID
+     * @param username 사용자명
+     * @param email 이메일 주소
+     * @param password 비밀번호
+     * @param profileId 프로필 이미지 ID (null 가능)
+     */
+    public User(UUID id, String username, String email, String password, UUID profileId) {
+        super(id);
+        this.username = username;
+        this.email = email;
+        this.password = password;
+        this.profileId = profileId;
+    }
+
+    /**
+     * 사용자 정보를 업데이트합니다.
+     * null이 아닌 값만 업데이트되며, 수정일시가 갱신됩니다.
+     *
+     * @param username 새로운 사용자명 (null이면 업데이트하지 않음)
+     * @param email 새로운 이메일 (null이면 업데이트하지 않음)
+     * @param password 새로운 비밀번호 (null이면 업데이트하지 않음)
+     * @param profileId 새로운 프로필 이미지 ID (null이면 업데이트하지 않음)
+     */
     public void update(String username, String email, String password, UUID profileId) {
         if (username != null) this.username = username;
         if (email != null) this.email = email;
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/UserStatus.java b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/UserStatus.java
index c6ea7138..b7a584d4 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/entity/UserStatus.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/entity/UserStatus.java
@@ -5,36 +5,58 @@
 import java.time.Instant;
 import java.util.UUID;
 
+/**
+ * 사용자 상태 엔티티 클래스
+ * 사용자의 접속 상태 및 마지막 활동 시간을 추적합니다.
+ */
 @Getter
 public class UserStatus extends BaseEntity {
+    /** 직렬화 버전 UID */
     @Serial
     private static final long serialVersionUID = 1L;
 
-    private final UUID userId;          // 사용자 ID
-    private Instant lastActiveAt;       // 마지막 접속 시간
+    /** 사용자 ID */
+    private final UUID userId;
 
-    public UserStatus(UUID userId, Instant lastActiveAt) {
+    /** 마지막 접속 시간 */
+    private Instant lastAccessAt;
+
+    /**
+     * 사용자 상태 생성자
+     *
+     * @param userId 사용자 ID
+     * @param lastAccessAt 마지막 접속 시간
+     */
+    public UserStatus(UUID userId, Instant lastAccessAt) {
         super();
         this.userId = userId;
-        this.lastActiveAt = lastActiveAt;
+        this.lastAccessAt = lastAccessAt;
     }
 
-    public void update(Instant lastActiveAt) {
-        if (lastActiveAt != null) {
-            this.lastActiveAt = lastActiveAt;
+    /**
+     * 마지막 활동 시간을 업데이트합니다.
+     * null이 아닌 값만 업데이트되며, 수정일시가 갱신됩니다.
+     *
+     * @param lastAccessAt 새로운 마지막 활동 시간 (null이면 업데이트하지 않음)
+     */
+    public void update(Instant lastAccessAt) {
+        if (lastAccessAt != null) {
+            this.lastAccessAt = lastAccessAt;
         }
         updateTimeStamp();
     }
 
     /**
-     * 현재 온라인 상태인지 확인
-     * 마지막 접속 시간이 현재 시간으로부터 5분 이내이면 온라인으로 간주
+     * 현재 온라인 상태인지 확인합니다.
+     * 마지막 접속 시간이 현재 시간으로부터 5분 이내이면 온라인으로 간주합니다.
+     *
+     * @return 온라인 상태 여부 (true: 온라인, false: 오프라인)
      */
     public boolean isOnline() {
-        if (lastActiveAt == null) {
+        if (lastAccessAt == null) {
             return false;
         }
         Instant fiveMinutesAgo = Instant.now().minusSeconds(5 * 60);
-        return lastActiveAt.isAfter(fiveMinutesAgo);
+        return lastAccessAt.isAfter(fiveMinutesAgo);
     }
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/exception/ErrorResponse.java b/discodeit/src/main/java/com/sprint/mission/discodeit/exception/ErrorResponse.java
new file mode 100644
index 00000000..16d828de
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/exception/ErrorResponse.java
@@ -0,0 +1,18 @@
+package com.sprint.mission.discodeit.exception;
+
+import java.time.Instant;
+
+/**
+ * API 에러 응답 DTO
+ *
+ * @param message 에러 메시지
+ * @param timestamp 에러 발생 시각
+ */
+public record ErrorResponse(
+		String message,
+		Instant timestamp
+) {
+	public static ErrorResponse of(String message) {
+		return new ErrorResponse(message, Instant.now());
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/exception/GlobalExceptionHandler.java b/discodeit/src/main/java/com/sprint/mission/discodeit/exception/GlobalExceptionHandler.java
new file mode 100644
index 00000000..bdb1fb23
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/exception/GlobalExceptionHandler.java
@@ -0,0 +1,51 @@
+package com.sprint.mission.discodeit.exception;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import java.util.NoSuchElementException;
+
+/**
+ * 전역 예외 처리 핸들러
+ *
+ * 모든 컨트롤러에서 발생하는 예외를 중앙에서 처리하여
+ * 일관된 에러 응답을 제공합니다.
+ */
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+	/**
+	 * NoSuchElementException 처리
+	 * - 존재하지 않는 리소스 조회 시 발생
+	 * - 404 NOT_FOUND 반환
+	 */
+	@ExceptionHandler(NoSuchElementException.class)
+	public ResponseEntity<ErrorResponse> handleNoSuchElement(NoSuchElementException e) {
+		ErrorResponse error = ErrorResponse.of(e.getMessage());
+		return ResponseEntity.status(HttpStatus.NOT_FOUND).body(error);
+	}
+
+	/**
+	 * IllegalArgumentException 처리
+	 * - 잘못된 요청 파라미터, 비즈니스 로직 위반 시 발생
+	 * - 400 BAD_REQUEST 반환
+	 */
+	@ExceptionHandler(IllegalArgumentException.class)
+	public ResponseEntity<ErrorResponse> handleIllegalArgument(IllegalArgumentException e) {
+		ErrorResponse error = ErrorResponse.of(e.getMessage());
+		return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
+	}
+
+	/**
+	 * 기타 모든 예외 처리
+	 * - 예상하지 못한 서버 에러
+	 * - 500 INTERNAL_SERVER_ERROR 반환
+	 */
+	@ExceptionHandler(Exception.class)
+	public ResponseEntity<ErrorResponse> handleException(Exception e) {
+		ErrorResponse error = ErrorResponse.of("서버 내부 오류가 발생했습니다: " + e.getMessage());
+		return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
+	}
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/BinaryContentRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/BinaryContentRepository.java
index a7ea2812..75a90670 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/BinaryContentRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/BinaryContentRepository.java
@@ -5,11 +5,54 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 바이너리 콘텐츠 저장소 인터페이스
+ * 바이너리 파일 데이터에 대한 CRUD 작업을 정의합니다.
+ */
 public interface BinaryContentRepository {
+    /**
+     * 바이너리 콘텐츠를 저장합니다.
+     *
+     * @param binaryContent 저장할 바이너리 콘텐츠
+     * @return 저장된 바이너리 콘텐츠
+     */
     BinaryContent save(BinaryContent binaryContent);
+
+    /**
+     * ID로 바이너리 콘텐츠를 조회합니다.
+     *
+     * @param id 바이너리 콘텐츠 ID
+     * @return 조회된 바이너리 콘텐츠 (Optional)
+     */
     Optional<BinaryContent> findById(UUID id);
+
+    /**
+     * 모든 바이너리 콘텐츠를 조회합니다.
+     *
+     * @return 모든 바이너리 콘텐츠 목록
+     */
     List<BinaryContent> findAll();
+
+    /**
+     * 여러 ID로 바이너리 콘텐츠 목록을 조회합니다.
+     *
+     * @param ids 바이너리 콘텐츠 ID 목록
+     * @return 조회된 바이너리 콘텐츠 목록
+     */
     List<BinaryContent> findAllByIdIn(List<UUID> ids);
+
+    /**
+     * ID로 바이너리 콘텐츠를 삭제합니다.
+     *
+     * @param id 삭제할 바이너리 콘텐츠 ID
+     */
     void deleteById(UUID id);
+
+    /**
+     * ID로 바이너리 콘텐츠의 존재 여부를 확인합니다.
+     *
+     * @param id 바이너리 콘텐츠 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ChannelRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ChannelRepository.java
index db818c11..8ab301a1 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ChannelRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ChannelRepository.java
@@ -6,10 +6,46 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 채널 저장소 인터페이스
+ * 채널 데이터에 대한 CRUD 작업을 정의합니다.
+ */
 public interface ChannelRepository {
+    /**
+     * 채널을 저장합니다.
+     *
+     * @param channel 저장할 채널
+     * @return 저장된 채널
+     */
     Channel save(Channel channel);
+
+    /**
+     * ID로 채널을 조회합니다.
+     *
+     * @param id 채널 ID
+     * @return 조회된 채널 (Optional)
+     */
     Optional<Channel> findById(UUID id);
+
+    /**
+     * 모든 채널을 조회합니다.
+     *
+     * @return 모든 채널 목록
+     */
     List<Channel> findAll();
+
+    /**
+     * ID로 채널을 삭제합니다.
+     *
+     * @param id 삭제할 채널 ID
+     */
     void deleteById(UUID id);
+
+    /**
+     * ID로 채널의 존재 여부를 확인합니다.
+     *
+     * @param id 채널 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
 }
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/MessageRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/MessageRepository.java
index a0fd4506..bddaa994 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/MessageRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/MessageRepository.java
@@ -6,12 +6,61 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 메시지 저장소 인터페이스
+ * 메시지 데이터에 대한 CRUD 작업을 정의합니다.
+ */
 public interface MessageRepository {
+    /**
+     * 메시지를 저장합니다.
+     *
+     * @param message 저장할 메시지
+     * @return 저장된 메시지
+     */
     Message save(Message message);
+
+    /**
+     * ID로 메시지를 조회합니다.
+     *
+     * @param id 메시지 ID
+     * @return 조회된 메시지 (Optional)
+     */
     Optional<Message> findById(UUID id);
+
+    /**
+     * 모든 메시지를 조회합니다.
+     *
+     * @return 모든 메시지 목록
+     */
     List<Message> findAll();
-    List<Message> findAllByChannelId(UUID channelId);  // 추가: 채널별 메시지 조회
+
+    /**
+     * 특정 채널의 모든 메시지를 조회합니다.
+     *
+     * @param channelId 채널 ID
+     * @return 해당 채널의 메시지 목록
+     */
+    List<Message> findAllByChannelId(UUID channelId);
+
+    /**
+     * ID로 메시지를 삭제합니다.
+     *
+     * @param id 삭제할 메시지 ID
+     */
     void deleteById(UUID id);
-    void deleteAllByChannelId(UUID channelId);         // 추가: 채널 삭제 시 메시지 일괄 삭제
+
+    /**
+     * 특정 채널의 모든 메시지를 일괄 삭제합니다.
+     *
+     * @param channelId 채널 ID
+     */
+    void deleteAllByChannelId(UUID channelId);
+
+    /**
+     * ID로 메시지의 존재 여부를 확인합니다.
+     *
+     * @param id 메시지 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
 }
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ReadStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ReadStatusRepository.java
index e6834f0b..7743a168 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ReadStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/ReadStatusRepository.java
@@ -5,14 +5,78 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 읽기 상태 저장소 인터페이스
+ * 사용자의 채널별 메시지 읽기 상태에 대한 CRUD 작업을 정의합니다.
+ */
 public interface ReadStatusRepository {
+    /**
+     * 읽기 상태를 저장합니다.
+     *
+     * @param readStatus 저장할 읽기 상태
+     * @return 저장된 읽기 상태
+     */
     ReadStatus save(ReadStatus readStatus);
+
+    /**
+     * ID로 읽기 상태를 조회합니다.
+     *
+     * @param id 읽기 상태 ID
+     * @return 조회된 읽기 상태 (Optional)
+     */
     Optional<ReadStatus> findById(UUID id);
+
+    /**
+     * 모든 읽기 상태를 조회합니다.
+     *
+     * @return 모든 읽기 상태 목록
+     */
     List<ReadStatus> findAll();
+
+    /**
+     * 특정 사용자의 모든 읽기 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 해당 사용자의 읽기 상태 목록
+     */
     List<ReadStatus> findAllByUserId(UUID userId);
+
+    /**
+     * 특정 채널의 모든 읽기 상태를 조회합니다.
+     *
+     * @param channelId 채널 ID
+     * @return 해당 채널의 읽기 상태 목록
+     */
     List<ReadStatus> findAllByChannelId(UUID channelId);
+
+    /**
+     * 특정 사용자의 특정 채널에 대한 읽기 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @param channelId 채널 ID
+     * @return 조회된 읽기 상태 (Optional)
+     */
     Optional<ReadStatus> findByUserIdAndChannelId(UUID userId, UUID channelId);
+
+    /**
+     * ID로 읽기 상태를 삭제합니다.
+     *
+     * @param id 삭제할 읽기 상태 ID
+     */
     void deleteById(UUID id);
+
+    /**
+     * 특정 채널의 모든 읽기 상태를 일괄 삭제합니다.
+     *
+     * @param channelId 채널 ID
+     */
     void deleteAllByChannelId(UUID channelId);
+
+    /**
+     * ID로 읽기 상태의 존재 여부를 확인합니다.
+     *
+     * @param id 읽기 상태 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserRepository.java
index f27189aa..ed03d430 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserRepository.java
@@ -6,14 +6,78 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 사용자 저장소 인터페이스
+ * 사용자 데이터에 대한 CRUD 작업 및 인증 관련 조회 기능을 정의합니다.
+ */
 public interface UserRepository {
+    /**
+     * 사용자를 저장합니다.
+     *
+     * @param user 저장할 사용자
+     * @return 저장된 사용자
+     */
     User save(User user);
+
+    /**
+     * ID로 사용자를 조회합니다.
+     *
+     * @param id 사용자 ID
+     * @return 조회된 사용자 (Optional)
+     */
     Optional<User> findById(UUID id);
-    Optional<User> findByUsername(String username);  // 추가: 로그인 시 사용
-    Optional<User> findByEmail(String email);        // 추가: 이메일 중복 체크
+
+    /**
+     * 사용자명으로 사용자를 조회합니다 (로그인 시 사용).
+     *
+     * @param username 사용자명
+     * @return 조회된 사용자 (Optional)
+     */
+    Optional<User> findByUsername(String username);
+
+    /**
+     * 이메일로 사용자를 조회합니다 (이메일 중복 체크 시 사용).
+     *
+     * @param email 이메일 주소
+     * @return 조회된 사용자 (Optional)
+     */
+    Optional<User> findByEmail(String email);
+
+    /**
+     * 모든 사용자를 조회합니다.
+     *
+     * @return 모든 사용자 목록
+     */
     List<User> findAll();
+
+    /**
+     * ID로 사용자를 삭제합니다.
+     *
+     * @param id 삭제할 사용자 ID
+     */
     void deleteById(UUID id);
+
+    /**
+     * ID로 사용자의 존재 여부를 확인합니다.
+     *
+     * @param id 사용자 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
-    boolean existsByUsername(String username);       // 추가: username 중복 체크
-    boolean existsByEmail(String email);             // 추가: email 중복 체크
+
+    /**
+     * 사용자명으로 사용자의 존재 여부를 확인합니다 (username 중복 체크).
+     *
+     * @param username 사용자명
+     * @return 존재 여부
+     */
+    boolean existsByUsername(String username);
+
+    /**
+     * 이메일로 사용자의 존재 여부를 확인합니다 (email 중복 체크).
+     *
+     * @param email 이메일 주소
+     * @return 존재 여부
+     */
+    boolean existsByEmail(String email);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserStatusRepository.java
index 0bf5175e..7cfce19f 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/UserStatusRepository.java
@@ -5,13 +5,69 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 사용자 상태 저장소 인터페이스
+ * 사용자의 온라인 상태 및 활동 정보에 대한 CRUD 작업을 정의합니다.
+ */
 public interface UserStatusRepository {
+    /**
+     * 사용자 상태를 저장합니다.
+     *
+     * @param userStatus 저장할 사용자 상태
+     * @return 저장된 사용자 상태
+     */
     UserStatus save(UserStatus userStatus);
+
+    /**
+     * ID로 사용자 상태를 조회합니다.
+     *
+     * @param id 사용자 상태 ID
+     * @return 조회된 사용자 상태 (Optional)
+     */
     Optional<UserStatus> findById(UUID id);
+
+    /**
+     * 사용자 ID로 사용자 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 조회된 사용자 상태 (Optional)
+     */
     Optional<UserStatus> findByUserId(UUID userId);
+
+    /**
+     * 모든 사용자 상태를 조회합니다.
+     *
+     * @return 모든 사용자 상태 목록
+     */
     List<UserStatus> findAll();
+
+    /**
+     * ID로 사용자 상태를 삭제합니다.
+     *
+     * @param id 삭제할 사용자 상태 ID
+     */
     void deleteById(UUID id);
+
+    /**
+     * 사용자 ID로 사용자 상태를 삭제합니다.
+     *
+     * @param userId 사용자 ID
+     */
     void deleteByUserId(UUID userId);
+
+    /**
+     * ID로 사용자 상태의 존재 여부를 확인합니다.
+     *
+     * @param id 사용자 상태 ID
+     * @return 존재 여부
+     */
     boolean existsById(UUID id);
+
+    /**
+     * 사용자 ID로 사용자 상태의 존재 여부를 확인합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 존재 여부
+     */
     boolean existsByUserId(UUID userId);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileBinaryContentRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileBinaryContentRepository.java
index 833a8f6c..8f08ea53 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileBinaryContentRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileBinaryContentRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 바이너리 콘텐츠 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileBinaryContentRepository implements BinaryContentRepository {
+    /** 바이너리 콘텐츠 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileBinaryContentRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileChannelRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileChannelRepository.java
index b01afd30..71328bcd 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileChannelRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileChannelRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 채널 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileChannelRepository implements ChannelRepository {
+    /** 채널 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileChannelRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileMessageRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileMessageRepository.java
index d40311c5..b6823564 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileMessageRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileMessageRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 메시지 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileMessageRepository implements MessageRepository {
+    /** 메시지 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileMessageRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileReadStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileReadStatusRepository.java
index 85ae76ad..3e875af4 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileReadStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileReadStatusRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 읽음 상태 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileReadStatusRepository implements ReadStatusRepository {
+    /** 읽음 상태 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileReadStatusRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserRepository.java
index a5473bd6..71477d33 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 사용자 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileUserRepository implements UserRepository {
+    /** 사용자 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileUserRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserStatusRepository.java
index 4453cf47..9b8cc5e6 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/file/FileUserStatusRepository.java
@@ -14,10 +14,16 @@
 import java.util.Optional;
 import java.util.UUID;
 
+/**
+ * 파일 기반 사용자 상태 저장소 구현체
+ * 직렬화를 사용하여 파일 시스템에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "file")
 public class FileUserStatusRepository implements UserStatusRepository {
+    /** 사용자 상태 파일을 저장하는 디렉토리 경로 */
     private final Path DIRECTORY;
+    /** 저장 파일의 확장자 (.ser) */
     private final String EXTENSION = ".ser";
 
     public FileUserStatusRepository(@Value("${discodeit.repository.file-directory}") String fileDirectory) {
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFBinaryContentRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFBinaryContentRepository.java
index 9987baf4..5a5b8ecf 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFBinaryContentRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFBinaryContentRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 바이너리 콘텐츠 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFBinaryContentRepository implements BinaryContentRepository {
+    /** 바이너리 콘텐츠를 저장하는 HashMap */
     private final Map<UUID, BinaryContent> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFChannelRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFChannelRepository.java
index 28b9a34e..76d96194 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFChannelRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFChannelRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 채널 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFChannelRepository implements ChannelRepository {
+    /** 채널을 저장하는 HashMap */
     private final Map<UUID, Channel> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFMessageRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFMessageRepository.java
index 73203604..b62b0b33 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFMessageRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFMessageRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 메시지 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFMessageRepository implements MessageRepository {
+    /** 메시지를 저장하는 HashMap */
     private final Map<UUID, Message> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFReadStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFReadStatusRepository.java
index 9397c253..e5586e2f 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFReadStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFReadStatusRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 읽기 상태 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFReadStatusRepository implements ReadStatusRepository {
+    /** 읽기 상태를 저장하는 HashMap */
     private final Map<UUID, ReadStatus> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserRepository.java
index 9cb492ea..b5fee54e 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 사용자 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFUserRepository implements UserRepository {
+    /** 사용자를 저장하는 HashMap */
     private final Map<UUID, User> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserStatusRepository.java b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserStatusRepository.java
index ca687b72..00b055f6 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserStatusRepository.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/repository/jcf/JCFUserStatusRepository.java
@@ -7,9 +7,14 @@
 
 import java.util.*;
 
+/**
+ * Java Collection Framework 기반 사용자 상태 저장소 구현체
+ * HashMap을 사용하여 메모리에 데이터를 저장합니다.
+ */
 @Repository
 @ConditionalOnProperty(name = "discodeit.repository.type", havingValue = "jcf", matchIfMissing = true)
 public class JCFUserStatusRepository implements UserStatusRepository {
+    /** 사용자 상태를 저장하는 HashMap */
     private final Map<UUID, UserStatus> data = new HashMap<>();
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/AuthService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/AuthService.java
index e6fcefd9..dc0b81e4 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/AuthService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/AuthService.java
@@ -3,6 +3,16 @@
 import com.sprint.mission.discodeit.dto.request.LoginRequest;
 import com.sprint.mission.discodeit.dto.response.UserResponse;
 
+/**
+ * 인증 서비스 인터페이스
+ * 사용자 로그인 및 인증 관련 기능을 정의합니다.
+ */
 public interface AuthService {
+    /**
+     * 사용자 로그인을 처리합니다.
+     *
+     * @param request 로그인 요청 정보 (사용자명, 비밀번호)
+     * @return 로그인한 사용자 정보
+     */
     UserResponse login(LoginRequest request);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/BinaryContentService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/BinaryContentService.java
index 463bbdf2..e4e1f0f1 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/BinaryContentService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/BinaryContentService.java
@@ -5,9 +5,39 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 바이너리 콘텐츠 서비스 인터페이스
+ * 파일 업로드, 조회, 삭제 등의 기능을 정의합니다.
+ */
 public interface BinaryContentService {
+    /**
+     * 바이너리 콘텐츠를 생성합니다.
+     *
+     * @param request 바이너리 콘텐츠 생성 요청
+     * @return 생성된 바이너리 콘텐츠
+     */
     BinaryContent create(BinaryContentCreateRequest request);
+
+    /**
+     * ID로 바이너리 콘텐츠를 조회합니다.
+     *
+     * @param id 바이너리 콘텐츠 ID
+     * @return 조회된 바이너리 콘텐츠
+     */
     BinaryContent find(UUID id);
+
+    /**
+     * 여러 ID로 바이너리 콘텐츠 목록을 조회합니다.
+     *
+     * @param ids 바이너리 콘텐츠 ID 목록
+     * @return 조회된 바이너리 콘텐츠 목록
+     */
     List<BinaryContent> findAllByIdIn(List<UUID> ids);
+
+    /**
+     * ID로 바이너리 콘텐츠를 삭제합니다.
+     *
+     * @param id 삭제할 바이너리 콘텐츠 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/ChannelService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/ChannelService.java
index fdcca611..7a66d045 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/ChannelService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/ChannelService.java
@@ -7,11 +7,56 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 채널 서비스 인터페이스
+ * 공개/비공개 채널 생성, 조회, 수정, 삭제 기능을 정의합니다.
+ */
 public interface ChannelService {
+    /**
+     * 공개 채널을 생성합니다.
+     *
+     * @param request 공개 채널 생성 요청
+     * @return 생성된 채널 정보
+     */
     ChannelResponse createPublic(PublicChannelCreateRequest request);
+
+    /**
+     * 비공개 채널을 생성합니다.
+     *
+     * @param request 비공개 채널 생성 요청
+     * @return 생성된 채널 정보
+     */
     ChannelResponse createPrivate(PrivateChannelCreateRequest request);
+
+    /**
+     * ID로 채널을 조회합니다.
+     *
+     * @param id 채널 ID
+     * @return 조회된 채널 정보
+     */
     ChannelResponse find(UUID id);
+
+    /**
+     * 특정 사용자가 접근 가능한 모든 채널을 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 사용자가 접근 가능한 채널 목록
+     */
     List<ChannelResponse> findAllByUserId(UUID userId);
+
+    /**
+     * 채널 정보를 업데이트합니다.
+     *
+     * @param id 채널 ID
+     * @param request 채널 업데이트 요청
+     * @return 업데이트된 채널 정보
+     */
     ChannelResponse update(UUID id, ChannelUpdateRequest request);
+
+    /**
+     * 채널을 삭제합니다.
+     *
+     * @param id 삭제할 채널 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/MessageService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/MessageService.java
index a7baa104..af7db695 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/MessageService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/MessageService.java
@@ -7,10 +7,49 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 메시지 서비스 인터페이스
+ * 메시지 생성, 조회, 수정, 삭제 및 첨부파일 처리 기능을 정의합니다.
+ */
 public interface MessageService {
+    /**
+     * 메시지를 생성합니다 (첨부파일 포함 가능).
+     *
+     * @param request 메시지 생성 요청
+     * @param attachmentRequests 첨부파일 목록
+     * @return 생성된 메시지 정보
+     */
     MessageResponse create(MessageCreateRequest request, List<BinaryContentCreateRequest> attachmentRequests);
+
+    /**
+     * ID로 메시지를 조회합니다.
+     *
+     * @param id 메시지 ID
+     * @return 조회된 메시지 정보
+     */
     MessageResponse find(UUID id);
+
+    /**
+     * 특정 채널의 모든 메시지를 조회합니다.
+     *
+     * @param channelId 채널 ID
+     * @return 해당 채널의 메시지 목록
+     */
     List<MessageResponse> findAllByChannelId(UUID channelId);
+
+    /**
+     * 메시지 내용을 업데이트합니다.
+     *
+     * @param id 메시지 ID
+     * @param request 메시지 업데이트 요청
+     * @return 업데이트된 메시지 정보
+     */
     MessageResponse update(UUID id, MessageUpdateRequest request);
+
+    /**
+     * 메시지를 삭제합니다.
+     *
+     * @param id 삭제할 메시지 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/ReadStatusService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/ReadStatusService.java
index 87ef9a02..a40c4c1d 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/ReadStatusService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/ReadStatusService.java
@@ -6,10 +6,48 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 읽기 상태 서비스 인터페이스
+ * 사용자의 채널별 메시지 읽기 상태를 관리하는 기능을 정의합니다.
+ */
 public interface ReadStatusService {
+    /**
+     * 읽기 상태를 생성합니다.
+     *
+     * @param request 읽기 상태 생성 요청
+     * @return 생성된 읽기 상태
+     */
     ReadStatus create(ReadStatusCreateRequest request);
+
+    /**
+     * ID로 읽기 상태를 조회합니다.
+     *
+     * @param id 읽기 상태 ID
+     * @return 조회된 읽기 상태
+     */
     ReadStatus find(UUID id);
+
+    /**
+     * 특정 사용자의 모든 읽기 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 해당 사용자의 읽기 상태 목록
+     */
     List<ReadStatus> findAllByUserId(UUID userId);
+
+    /**
+     * 읽기 상태를 업데이트합니다.
+     *
+     * @param id 읽기 상태 ID
+     * @param request 읽기 상태 업데이트 요청
+     * @return 업데이트된 읽기 상태
+     */
     ReadStatus update(UUID id, ReadStatusUpdateRequest request);
+
+    /**
+     * 읽기 상태를 삭제합니다.
+     *
+     * @param id 삭제할 읽기 상태 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserService.java
index a9646a38..4d401c8b 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserService.java
@@ -3,14 +3,62 @@
 import com.sprint.mission.discodeit.dto.request.BinaryContentCreateRequest;
 import com.sprint.mission.discodeit.dto.request.UserCreateRequest;
 import com.sprint.mission.discodeit.dto.request.UserUpdateRequest;
+import com.sprint.mission.discodeit.dto.response.UserDto;
 import com.sprint.mission.discodeit.dto.response.UserResponse;
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 사용자 서비스 인터페이스
+ * 사용자 생성, 조회, 수정, 삭제 및 프로필 이미지 관리 기능을 정의합니다.
+ */
 public interface UserService {
+    /**
+     * 사용자를 생성합니다 (프로필 이미지 포함 가능).
+     *
+     * @param request 사용자 생성 요청
+     * @param profileRequest 프로필 이미지 생성 요청 (null 가능)
+     * @return 생성된 사용자 정보
+     */
     UserResponse create(UserCreateRequest request, BinaryContentCreateRequest profileRequest);
+
+    /**
+     * ID로 사용자를 조회합니다.
+     *
+     * @param id 사용자 ID
+     * @return 조회된 사용자 정보
+     */
     UserResponse find(UUID id);
+
+    /**
+     * 모든 사용자를 조회합니다.
+     *
+     * @return 모든 사용자 목록
+     */
     List<UserResponse> findAll();
+
+    /**
+     * 모든 사용자를 UserDto 형식으로 조회합니다.
+     * API 스펙에 맞는 형식으로 반환합니다.
+     *
+     * @return 모든 사용자 목록 (UserDto 형식)
+     */
+    List<UserDto> findAllAsDto();
+
+    /**
+     * 사용자 정보를 업데이트합니다 (프로필 이미지 변경 가능).
+     *
+     * @param id 사용자 ID
+     * @param request 사용자 업데이트 요청
+     * @param profileRequest 프로필 이미지 업데이트 요청 (null 가능)
+     * @return 업데이트된 사용자 정보
+     */
     UserResponse update(UUID id, UserUpdateRequest request, BinaryContentCreateRequest profileRequest);
+
+    /**
+     * 사용자를 삭제합니다.
+     *
+     * @param id 삭제할 사용자 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserStatusService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserStatusService.java
index bc7f79b8..7fb58dab 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserStatusService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/UserStatusService.java
@@ -6,12 +6,64 @@
 import java.util.List;
 import java.util.UUID;
 
+/**
+ * 사용자 상태 서비스 인터페이스
+ * 사용자의 온라인 상태 및 활동 정보를 관리하는 기능을 정의합니다.
+ */
 public interface UserStatusService {
+    /**
+     * 사용자 상태를 생성합니다.
+     *
+     * @param request 사용자 상태 생성 요청
+     * @return 생성된 사용자 상태
+     */
     UserStatus create(UserStatusCreateRequest request);
+
+    /**
+     * ID로 사용자 상태를 조회합니다.
+     *
+     * @param id 사용자 상태 ID
+     * @return 조회된 사용자 상태
+     */
     UserStatus find(UUID id);
+
+    /**
+     * 사용자 ID로 사용자 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 조회된 사용자 상태
+     */
     UserStatus findByUserId(UUID userId);
+
+    /**
+     * 모든 사용자 상태를 조회합니다.
+     *
+     * @return 모든 사용자 상태 목록
+     */
     List<UserStatus> findAll();
+
+    /**
+     * 사용자 상태를 업데이트합니다.
+     *
+     * @param id 사용자 상태 ID
+     * @param request 사용자 상태 업데이트 요청
+     * @return 업데이트된 사용자 상태
+     */
     UserStatus update(UUID id, UserStatusUpdateRequest request);
+
+    /**
+     * 사용자 ID로 사용자 상태를 업데이트합니다.
+     *
+     * @param userId 사용자 ID
+     * @param request 사용자 상태 업데이트 요청
+     * @return 업데이트된 사용자 상태
+     */
     UserStatus updateByUserId(UUID userId, UserStatusUpdateRequest request);
+
+    /**
+     * 사용자 상태를 삭제합니다.
+     *
+     * @param id 삭제할 사용자 상태 ID
+     */
     void delete(UUID id);
 }
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicAuthService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicAuthService.java
index 646adfb5..36f8c4e2 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicAuthService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicAuthService.java
@@ -12,12 +12,30 @@
 
 import java.util.NoSuchElementException;
 
+/**
+ * AuthService 인터페이스의 기본 구현체.
+ * 사용자 인증 및 로그인 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicAuthService implements AuthService {
+    /**
+     * 사용자 정보를 저장하고 조회하는 리포지토리
+     */
     private final UserRepository userRepository;
+
+    /**
+     * 사용자 상태 정보를 저장하고 조회하는 리포지토리
+     */
     private final UserStatusRepository userStatusRepository;
 
+    /**
+     * 사용자 로그인을 처리합니다.
+     *
+     * @param request 로그인 요청 정보 (username, password)
+     * @return 로그인한 사용자의 정보
+     * @throws NoSuchElementException 사용자를 찾을 수 없거나 비밀번호가 일치하지 않을 경우
+     */
     @Override
     public UserResponse login(LoginRequest request) {
         // username으로 User 조회
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicBinaryContentService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicBinaryContentService.java
index 890fa2b2..4f1483bf 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicBinaryContentService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicBinaryContentService.java
@@ -11,9 +11,16 @@
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * BinaryContentService 인터페이스의 기본 구현체.
+ * 바이너리 콘텐츠(파일, 이미지 등)의 저장 및 조회 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicBinaryContentService implements BinaryContentService {
+    /**
+     * 바이너리 콘텐츠를 저장하고 조회하는 리포지토리
+     */
     private final BinaryContentRepository binaryContentRepository;
 
     @Override
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicChannelService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicChannelService.java
index 8a4689b7..00683df7 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicChannelService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicChannelService.java
@@ -21,12 +21,31 @@
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * ChannelService 인터페이스의 기본 구현체.
+ * 채널(PUBLIC, PRIVATE)의 생성, 조회, 수정, 삭제 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicChannelService implements ChannelService {
+    /**
+     * 채널 정보를 저장하고 조회하는 리포지토리
+     */
     private final ChannelRepository channelRepository;
+
+    /**
+     * 채널별 사용자 읽기 상태를 저장하고 조회하는 리포지토리
+     */
     private final ReadStatusRepository readStatusRepository;
+
+    /**
+     * 메시지 정보를 저장하고 조회하는 리포지토리
+     */
     private final MessageRepository messageRepository;
+
+    /**
+     * 바이너리 콘텐츠(첨부파일)를 저장하고 조회하는 리포지토리
+     */
     private final BinaryContentRepository binaryContentRepository;
 
     @Override
@@ -36,6 +55,13 @@ public ChannelResponse createPublic(PublicChannelCreateRequest request) {
         return toChannelResponse(savedChannel);
     }
 
+    /**
+     * PRIVATE 채널을 생성합니다.
+     * 참여자 목록에 있는 각 사용자에 대한 ReadStatus도 함께 생성합니다.
+     *
+     * @param request PRIVATE 채널 생성 요청 정보 (참여자 ID 목록 포함)
+     * @return 생성된 채널 정보
+     */
     @Override
     public ChannelResponse createPrivate(PrivateChannelCreateRequest request) {
         // PRIVATE 채널은 name, description 없음
@@ -43,7 +69,7 @@ public ChannelResponse createPrivate(PrivateChannelCreateRequest request) {
         Channel savedChannel = channelRepository.save(channel);
 
         // 참여자별 ReadStatus 생성
-        for (UUID userId : request.participantIds()) {
+        for (UUID userId : request.memberIds()) {
             ReadStatus readStatus = new ReadStatus(userId, savedChannel.getId(), Instant.now());
             readStatusRepository.save(readStatus);
         }
@@ -58,6 +84,13 @@ public ChannelResponse find(UUID id) {
         return toChannelResponse(channel);
     }
 
+    /**
+     * 특정 사용자가 접근 가능한 모든 채널을 조회합니다.
+     * PUBLIC 채널은 모두 조회 가능하며, PRIVATE 채널은 참여자만 조회 가능합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 접근 가능한 채널 목록
+     */
     @Override
     public List<ChannelResponse> findAllByUserId(UUID userId) {
         List<Channel> allChannels = channelRepository.findAll();
@@ -91,6 +124,13 @@ public ChannelResponse update(UUID id, ChannelUpdateRequest request) {
         return toChannelResponse(savedChannel);
     }
 
+    /**
+     * 채널을 삭제합니다.
+     * 연관된 메시지, 첨부파일, ReadStatus도 함께 삭제합니다.
+     *
+     * @param id 삭제할 채널 ID
+     * @throws NoSuchElementException 채널을 찾을 수 없을 경우
+     */
     @Override
     public void delete(UUID id) {
         Channel channel = channelRepository.findById(id)
@@ -113,6 +153,13 @@ public void delete(UUID id) {
         channelRepository.deleteById(id);
     }
 
+    /**
+     * Channel 엔티티를 ChannelResponse DTO로 변환합니다.
+     * 최근 메시지 시간과 참여자 목록(PRIVATE 채널의 경우)을 포함합니다.
+     *
+     * @param channel 변환할 Channel 엔티티
+     * @return ChannelResponse DTO
+     */
     private ChannelResponse toChannelResponse(Channel channel) {
         // 최근 메시지 시간 조회
         Instant lastMessageAt = messageRepository.findAllByChannelId(channel.getId()).stream()
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicMessageService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicMessageService.java
index 552ae80a..efd4c835 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicMessageService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicMessageService.java
@@ -11,23 +11,43 @@
 import com.sprint.mission.discodeit.service.MessageService;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
+import org.springframework.util.CollectionUtils;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * MessageService 인터페이스의 기본 구현체.
+ * 메시지의 생성, 조회, 수정, 삭제 및 첨부파일 관리 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicMessageService implements MessageService {
+    /**
+     * 메시지 정보를 저장하고 조회하는 리포지토리
+     */
     private final MessageRepository messageRepository;
+
+    /**
+     * 메시지 첨부파일을 저장하고 조회하는 리포지토리
+     */
     private final BinaryContentRepository binaryContentRepository;
 
+    /**
+     * 메시지를 생성합니다.
+     * 첨부파일이 있는 경우 함께 저장합니다.
+     *
+     * @param request 메시지 생성 요청 정보
+     * @param attachmentRequests 첨부파일 목록 (선택 사항)
+     * @return 생성된 메시지 정보
+     */
     @Override
     public MessageResponse create(MessageCreateRequest request, List<BinaryContentCreateRequest> attachmentRequests) {
         // 첨부파일 저장 (선택적)
         List<UUID> attachmentIds = new ArrayList<>();
-        if (attachmentRequests != null && !attachmentRequests.isEmpty()) {
+        if (!CollectionUtils.isEmpty(attachmentRequests)) {
             for (BinaryContentCreateRequest attachmentRequest : attachmentRequests) {
                 BinaryContent attachment = new BinaryContent(
                         attachmentRequest.fileName(),
@@ -73,13 +93,20 @@ public MessageResponse update(UUID id, MessageUpdateRequest request) {
         return toMessageResponse(savedMessage);
     }
 
+    /**
+     * 메시지를 삭제합니다.
+     * 연관된 첨부파일도 함께 삭제합니다.
+     *
+     * @param id 삭제할 메시지 ID
+     * @throws NoSuchElementException 메시지를 찾을 수 없을 경우
+     */
     @Override
     public void delete(UUID id) {
         Message message = messageRepository.findById(id)
                 .orElseThrow(() -> new NoSuchElementException("Message not found: " + id));
 
         // 첨부파일 삭제
-        if (message.getAttachmentIds() != null) {
+        if (!CollectionUtils.isEmpty(message.getAttachmentIds())) {
             for (UUID attachmentId : message.getAttachmentIds()) {
                 binaryContentRepository.deleteById(attachmentId);
             }
@@ -89,6 +116,12 @@ public void delete(UUID id) {
         messageRepository.deleteById(id);
     }
 
+    /**
+     * Message 엔티티를 MessageResponse DTO로 변환합니다.
+     *
+     * @param message 변환할 Message 엔티티
+     * @return MessageResponse DTO
+     */
     private MessageResponse toMessageResponse(Message message) {
         return new MessageResponse(
                 message.getId(),
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicReadStatusService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicReadStatusService.java
index 414e0241..1d767309 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicReadStatusService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicReadStatusService.java
@@ -14,13 +14,37 @@
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * ReadStatusService 인터페이스의 기본 구현체.
+ * 사용자의 채널별 읽기 상태 관리 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicReadStatusService implements ReadStatusService {
+    /**
+     * 읽기 상태 정보를 저장하고 조회하는 리포지토리
+     */
     private final ReadStatusRepository readStatusRepository;
+
+    /**
+     * 사용자 존재 여부 확인을 위한 리포지토리
+     */
     private final UserRepository userRepository;
+
+    /**
+     * 채널 존재 여부 확인을 위한 리포지토리
+     */
     private final ChannelRepository channelRepository;
 
+    /**
+     * 읽기 상태를 생성합니다.
+     * 사용자와 채널의 존재 여부를 확인하고, 중복 생성을 방지합니다.
+     *
+     * @param request 읽기 상태 생성 요청 정보
+     * @return 생성된 읽기 상태
+     * @throws NoSuchElementException 사용자 또는 채널을 찾을 수 없을 경우
+     * @throws IllegalArgumentException 해당 사용자와 채널의 읽기 상태가 이미 존재할 경우
+     */
     @Override
     public ReadStatus create(ReadStatusCreateRequest request) {
         // User 존재 여부 확인
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserService.java
index 5bacfd19..98eba8c3 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserService.java
@@ -3,6 +3,7 @@
 import com.sprint.mission.discodeit.dto.request.BinaryContentCreateRequest;
 import com.sprint.mission.discodeit.dto.request.UserCreateRequest;
 import com.sprint.mission.discodeit.dto.request.UserUpdateRequest;
+import com.sprint.mission.discodeit.dto.response.UserDto;
 import com.sprint.mission.discodeit.dto.response.UserResponse;
 import com.sprint.mission.discodeit.entity.BinaryContent;
 import com.sprint.mission.discodeit.entity.User;
@@ -19,25 +20,51 @@
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * UserService 인터페이스의 기본 구현체.
+ * 사용자의 생성, 조회, 수정, 삭제 및 프로필 이미지 관리 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicUserService implements UserService {
+
+    /**
+     * 사용자 정보를 저장하고 조회하는 리포지토리
+     */
     private final UserRepository userRepository;
+
+    /**
+     * 프로필 이미지를 저장하고 조회하는 리포지토리
+     */
     private final BinaryContentRepository binaryContentRepository;
+
+    /**
+     * 사용자 상태 정보를 저장하고 조회하는 리포지토리
+     */
     private final UserStatusRepository userStatusRepository;
 
+    /**
+     * 사용자를 생성합니다.
+     * 사용자 이름과 이메일 중복을 확인하고, 프로필 이미지가 있는 경우 함께 저장합니다.
+     *
+     * @param request 사용자 생성 요청 정보
+     * @param profileRequest 프로필 이미지 정보 (선택 사항)
+     * @return 생성된 사용자 정보
+     * @throws IllegalArgumentException 사용자 이름 또는 이메일이 이미 존재할 경우
+     */
     @Override
     public UserResponse create(UserCreateRequest request, BinaryContentCreateRequest profileRequest) {
-        // username 중복 체크
+        // 1. 사용자 이름 중복 체크
         if (userRepository.existsByUsername(request.username())) {
-            throw new IllegalArgumentException("Username already exists: " + request.username());
+            throw new IllegalArgumentException("이 사용자 이름은 이미 존재해요!: " + request.username());
         }
-        // email 중복 체크
+
+        // 2. 이메일 중복 체크
         if (userRepository.existsByEmail(request.email())) {
-            throw new IllegalArgumentException("Email already exists: " + request.email());
+            throw new IllegalArgumentException("이 이메일은 이미 존재해요!: " + request.email());
         }
 
-        // 프로필 이미지 저장 (선택적)
+        // 3. 프로필 이미지 저장 (선택 사항)
         UUID profileId = null;
         if (profileRequest != null) {
             BinaryContent profile = new BinaryContent(
@@ -48,7 +75,7 @@ public UserResponse create(UserCreateRequest request, BinaryContentCreateRequest
             profileId = binaryContentRepository.save(profile).getId();
         }
 
-        // User 생성
+        // 4. User 객체 생성
         User user = new User(
                 request.username(),
                 request.email(),
@@ -57,10 +84,11 @@ public UserResponse create(UserCreateRequest request, BinaryContentCreateRequest
         );
         User savedUser = userRepository.save(user);
 
-        // UserStatus 생성
+        // 5. UserStatus 객체 생성 및 저장
         UserStatus userStatus = new UserStatus(savedUser.getId(), Instant.now());
         userStatusRepository.save(userStatus);
 
+        // 6. 최종 결과 반환
         return toUserResponse(savedUser, true);
     }
 
@@ -68,6 +96,7 @@ public UserResponse create(UserCreateRequest request, BinaryContentCreateRequest
     public UserResponse find(UUID id) {
         User user = userRepository.findById(id)
                 .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
+
         boolean isOnline = getOnlineStatus(user.getId());
         return toUserResponse(user, isOnline);
     }
@@ -79,19 +108,46 @@ public List<UserResponse> findAll() {
                 .toList();
     }
 
+    @Override
+    public List<UserDto> findAllAsDto() {
+        return userRepository.findAll().stream()
+                .map(user -> {
+                    boolean isOnline = getOnlineStatus(user.getId());
+                    return new UserDto(
+                            user.getId(),
+                            user.getCreatedAt(),
+                            user.getUpdatedAt(),
+                            user.getUsername(),
+                            user.getEmail(),
+                            user.getProfileId(),
+                            isOnline
+                    );
+                })
+                .toList();
+    }
+
+    /**
+     * 사용자 정보를 수정합니다.
+     * 프로필 이미지가 변경되는 경우 기존 이미지를 삭제하고 새 이미지를 저장합니다.
+     *
+     * @param id 수정할 사용자 ID
+     * @param request 사용자 수정 요청 정보
+     * @param profileRequest 새 프로필 이미지 정보 (선택 사항)
+     * @return 수정된 사용자 정보
+     * @throws NoSuchElementException 사용자를 찾을 수 없을 경우
+     */
     @Override
     public UserResponse update(UUID id, UserUpdateRequest request, BinaryContentCreateRequest profileRequest) {
+        // 1. 수정할 사용자 먼저 찾기
         User user = userRepository.findById(id)
                 .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
 
-        // 프로필 이미지 대체 (선택적)
+        // 2. 프로필 이미지 교체 (선택 사항)
         UUID newProfileId = user.getProfileId();
         if (profileRequest != null) {
-            // 기존 프로필 이미지 삭제
             if (user.getProfileId() != null) {
                 binaryContentRepository.deleteById(user.getProfileId());
             }
-            // 새 프로필 이미지 저장
             BinaryContent profile = new BinaryContent(
                     profileRequest.fileName(),
                     profileRequest.contentType(),
@@ -100,34 +156,60 @@ public UserResponse update(UUID id, UserUpdateRequest request, BinaryContentCrea
             newProfileId = binaryContentRepository.save(profile).getId();
         }
 
+        // 3. 사용자 정보 업데이트
         user.update(request.username(), request.email(), request.password(), newProfileId);
+
+        // 4. 변경된 정보 저장
         User savedUser = userRepository.save(user);
 
+        // 5. 최종 결과 반환
         boolean isOnline = getOnlineStatus(savedUser.getId());
         return toUserResponse(savedUser, isOnline);
     }
 
+    /**
+     * 사용자를 삭제합니다.
+     * 연관된 프로필 이미지와 상태 정보도 함께 삭제합니다.
+     *
+     * @param id 삭제할 사용자 ID
+     * @throws NoSuchElementException 사용자를 찾을 수 없을 경우
+     */
     @Override
     public void delete(UUID id) {
+        // 1. 삭제할 사용자 먼저 찾기
         User user = userRepository.findById(id)
                 .orElseThrow(() -> new NoSuchElementException("User not found: " + id));
 
-        // 프로필 이미지 삭제
+        // 2. 연관된 데이터들 먼저 삭제하기
         if (user.getProfileId() != null) {
             binaryContentRepository.deleteById(user.getProfileId());
         }
-        // UserStatus 삭제
         userStatusRepository.deleteByUserId(id);
-        // User 삭제
+
+        // 3. 최종적으로 사용자 삭제
         userRepository.deleteById(id);
     }
 
+    /**
+     * 사용자의 온라인 상태를 조회합니다.
+     *
+     * @param userId 사용자 ID
+     * @return 온라인 여부 (상태 정보가 없으면 false)
+     */
     private boolean getOnlineStatus(UUID userId) {
         return userStatusRepository.findByUserId(userId)
                 .map(UserStatus::isOnline)
                 .orElse(false);
     }
 
+    /**
+     * User 엔티티를 UserResponse DTO로 변환합니다.
+     * 비밀번호는 포함하지 않습니다.
+     *
+     * @param user 변환할 User 엔티티
+     * @param isOnline 온라인 상태
+     * @return UserResponse DTO
+     */
     private UserResponse toUserResponse(User user, boolean isOnline) {
         return new UserResponse(
                 user.getId(),
diff --git a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserStatusService.java b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserStatusService.java
index c58c3975..67fa49f0 100644
--- a/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserStatusService.java
+++ b/discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicUserStatusService.java
@@ -13,12 +13,32 @@
 import java.util.NoSuchElementException;
 import java.util.UUID;
 
+/**
+ * UserStatusService 인터페이스의 기본 구현체.
+ * 사용자 상태(온라인/오프라인) 관리 기능을 제공합니다.
+ */
 @Service
 @RequiredArgsConstructor
 public class BasicUserStatusService implements UserStatusService {
+    /**
+     * 사용자 상태 정보를 저장하고 조회하는 리포지토리
+     */
     private final UserStatusRepository userStatusRepository;
+
+    /**
+     * 사용자 존재 여부 확인을 위한 리포지토리
+     */
     private final UserRepository userRepository;
 
+    /**
+     * 사용자 상태를 생성합니다.
+     * 사용자의 존재 여부를 확인하고, 중복 생성을 방지합니다.
+     *
+     * @param request 사용자 상태 생성 요청 정보
+     * @return 생성된 사용자 상태
+     * @throws NoSuchElementException 사용자를 찾을 수 없을 경우
+     * @throws IllegalArgumentException 해당 사용자의 상태가 이미 존재할 경우
+     */
     @Override
     public UserStatus create(UserStatusCreateRequest request) {
         // User 존재 여부 확인
@@ -30,7 +50,7 @@ public UserStatus create(UserStatusCreateRequest request) {
             throw new IllegalArgumentException("UserStatus already exists for user: " + request.userId());
         }
 
-        UserStatus userStatus = new UserStatus(request.userId(), request.lastActiveAt());
+        UserStatus userStatus = new UserStatus(request.userId(), request.lastAccessAt());
         return userStatusRepository.save(userStatus);
     }
 
@@ -55,7 +75,7 @@ public List<UserStatus> findAll() {
     public UserStatus update(UUID id, UserStatusUpdateRequest request) {
         UserStatus userStatus = userStatusRepository.findById(id)
                 .orElseThrow(() -> new NoSuchElementException("UserStatus not found: " + id));
-        userStatus.update(request.lastActiveAt());
+        userStatus.update(request.lastAccessAt());
         return userStatusRepository.save(userStatus);
     }
 
@@ -63,7 +83,7 @@ public UserStatus update(UUID id, UserStatusUpdateRequest request) {
     public UserStatus updateByUserId(UUID userId, UserStatusUpdateRequest request) {
         UserStatus userStatus = userStatusRepository.findByUserId(userId)
                 .orElseThrow(() -> new NoSuchElementException("UserStatus not found for user: " + userId));
-        userStatus.update(request.lastActiveAt());
+        userStatus.update(request.lastAccessAt());
         return userStatusRepository.save(userStatus);
     }
 
diff --git a/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_collection.json b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_collection.json
new file mode 100644
index 00000000..e3602f2d
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_collection.json	
@@ -0,0 +1,755 @@
+{
+  "info": {
+    "name": "Discodeit API",
+    "description": "Discodeit API 자동 테스트 컬렉션\n\n고정 UUID를 사용하여 재시작 후에도 안정적인 테스트가 가능합니다.",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+    "_exporter_id": "discodeit-api"
+  },
+  "item": [
+    {
+      "name": "사용자 관리",
+      "item": [
+        {
+          "name": "모든 사용자 조회",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const users = pm.response.json();",
+                  "    if (!Array.isArray(users)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (users.length === 0) {",
+                  "        throw new Error('사용자 목록이 비어있음');",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'username', 'email', 'online'];",
+                  "    const missingFields = requiredFields.filter(field => !users[0].hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('모든 사용자 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`모든 사용자 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/users",
+              "host": ["{{baseUrl}}"],
+              "path": ["users"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "특정 사용자 조회 (이영희)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    if (typeof user !== 'object' || Array.isArray(user)) {",
+                  "        throw new Error('응답이 객체가 아님');",
+                  "    }",
+                  "    ",
+                  "    const expectedId = pm.environment.get('user2Id');",
+                  "    if (user.id !== expectedId) {",
+                  "        throw new Error(`사용자 ID 불일치: ${user.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'username', 'email'];",
+                  "    const missingFields = requiredFields.filter(field => !user.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('특정 사용자 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`특정 사용자 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user2Id}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user2Id}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 생성 (JSON)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 201) {",
+                  "        const error = pm.response.json();",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200 또는 201) - ${error.message || ''}`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    if (!user.id) {",
+                  "        throw new Error('생성된 사용자에 ID가 없음');",
+                  "    }",
+                  "    ",
+                  "    if (!user.email) {",
+                  "        throw new Error('생성된 사용자에 이메일이 없음');",
+                  "    }",
+                  "    ",
+                  "    // 다음 테스트를 위해 생성된 사용자 ID 저장",
+                  "    pm.environment.set('createdUserId', user.id);",
+                  "    ",
+                  "    pm.test('사용자 생성 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 생성 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            },
+            {
+              "listen": "prerequest",
+              "script": {
+                "exec": [
+                  "// 매번 다른 이메일 생성",
+                  "pm.environment.set('randomEmail', 'newuser' + Date.now() + '@example.com');"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"새로운사용자\",\n  \"email\": \"{{randomEmail}}\",\n  \"password\": \"password123\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users",
+              "host": ["{{baseUrl}}"],
+              "path": ["users"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "사용자 수정 (이영희)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const user = pm.response.json();",
+                  "    const expectedId = pm.environment.get('user2Id');",
+                  "    if (user.id !== expectedId) {",
+                  "        throw new Error(`사용자 ID 변경됨: ${user.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('사용자 수정 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 수정 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"{{user2Name}}_수정됨\",\n  \"email\": \"{{user2Email}}\",\n  \"password\": \"newpassword123\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user2Id}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user2Id}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "생성된 사용자 삭제",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200 && pm.response.code !== 204) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200 또는 204)`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('사용자 삭제 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`사용자 삭제 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "DELETE",
+            "header": [],
+            "url": {
+              "raw": "{{baseUrl}}/users/{{createdUserId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{createdUserId}}"]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "사용자 상태 관리",
+      "item": [
+        {
+          "name": "이영희 온라인 상태 업데이트",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user2Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user2Id}}", "status"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "박민수 온라인 상태 업데이트",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user3Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user3Id}}", "status"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "최지연 온라인 상태 업데이트",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const status = pm.response.json();",
+                  "    if (!status.hasOwnProperty('lastAccessAt')) {",
+                  "        throw new Error('lastAccessAt 필드가 응답에 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('온라인 상태 업데이트 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`온라인 상태 업데이트 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "PUT",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"lastAccessAt\": \"{{$isoTimestamp}}\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users/{{user4Id}}/status",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "{{user4Id}}", "status"]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "바이너리 콘텐츠",
+      "item": [
+        {
+          "name": "파일 1개 조회 (이영희 프로필)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const content = pm.response.json();",
+                  "    const expectedId = pm.environment.get('user2ProfileId');",
+                  "    if (content.id !== expectedId) {",
+                  "        throw new Error(`파일 ID 불일치: ${content.id} (예상: ${expectedId})`);",
+                  "    }",
+                  "    ",
+                  "    const requiredFields = ['id', 'filename', 'contentType'];",
+                  "    const missingFields = requiredFields.filter(field => !content.hasOwnProperty(field));",
+                  "    if (missingFields.length > 0) {",
+                  "        throw new Error(`필수 필드 누락: ${missingFields.join(', ')}`);",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents/{{user2ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents", "{{user2ProfileId}}"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "파일 여러개 조회 (2명)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const contents = pm.response.json();",
+                  "    if (!Array.isArray(contents)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (contents.length === 0) {",
+                  "        throw new Error('조회된 파일이 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 여러개 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 여러개 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents?ids={{user2ProfileId}},{{user3ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents"],
+              "query": [
+                {
+                  "key": "ids",
+                  "value": "{{user2ProfileId}},{{user3ProfileId}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "파일 여러개 조회 (전체)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 200) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 200)`);",
+                  "    }",
+                  "    ",
+                  "    const contents = pm.response.json();",
+                  "    if (!Array.isArray(contents)) {",
+                  "        throw new Error('응답이 배열이 아님');",
+                  "    }",
+                  "    ",
+                  "    if (contents.length === 0) {",
+                  "        throw new Error('조회된 파일이 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('파일 여러개 조회 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`파일 여러개 조회 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents?ids={{user2ProfileId}},{{user3ProfileId}},{{user4ProfileId}}",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents"],
+              "query": [
+                {
+                  "key": "ids",
+                  "value": "{{user2ProfileId}},{{user3ProfileId}},{{user4ProfileId}}"
+                }
+              ]
+            }
+          },
+          "response": []
+        }
+      ]
+    },
+    {
+      "name": "에러 케이스 테스트",
+      "item": [
+        {
+          "name": "중복 이메일로 사용자 생성 (400 에러)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 400) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 400)`);",
+                  "    }",
+                  "    ",
+                  "    const error = pm.response.json();",
+                  "    if (!error.hasOwnProperty('message')) {",
+                  "        throw new Error('에러 응답에 message 필드가 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('중복 이메일 에러 검증 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`중복 이메일 에러 검증 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "POST",
+            "header": [
+              {
+                "key": "Content-Type",
+                "value": "application/json"
+              }
+            ],
+            "body": {
+              "mode": "raw",
+              "raw": "{\n  \"username\": \"중복테스트\",\n  \"email\": \"{{user2Email}}\",\n  \"password\": \"test1234\"\n}"
+            },
+            "url": {
+              "raw": "{{baseUrl}}/users",
+              "host": ["{{baseUrl}}"],
+              "path": ["users"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "존재하지 않는 사용자 조회 (404 에러)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 404) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 404)`);",
+                  "    }",
+                  "    ",
+                  "    const error = pm.response.json();",
+                  "    if (!error.hasOwnProperty('message')) {",
+                  "        throw new Error('에러 응답에 message 필드가 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('존재하지 않는 사용자 에러 검증 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`존재하지 않는 사용자 에러 검증 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/users/00000000-0000-0000-0000-000000000000",
+              "host": ["{{baseUrl}}"],
+              "path": ["users", "00000000-0000-0000-0000-000000000000"]
+            }
+          },
+          "response": []
+        },
+        {
+          "name": "존재하지 않는 파일 조회 (404 에러)",
+          "event": [
+            {
+              "listen": "test",
+              "script": {
+                "exec": [
+                  "try {",
+                  "    if (pm.response.code !== 404) {",
+                  "        throw new Error(`상태 코드 오류: ${pm.response.code} (예상: 404)`);",
+                  "    }",
+                  "    ",
+                  "    const error = pm.response.json();",
+                  "    if (!error.hasOwnProperty('message')) {",
+                  "        throw new Error('에러 응답에 message 필드가 없음');",
+                  "    }",
+                  "    ",
+                  "    pm.test('존재하지 않는 파일 에러 검증 성공', () => {",
+                  "        pm.expect(true).to.be.true;",
+                  "    });",
+                  "} catch (error) {",
+                  "    pm.test(`존재하지 않는 파일 에러 검증 실패: ${error.message}`, () => {",
+                  "        pm.expect.fail(error.message);",
+                  "    });",
+                  "}"
+                ],
+                "type": "text/javascript"
+              }
+            }
+          ],
+          "request": {
+            "method": "GET",
+            "header": [
+              {
+                "key": "Accept",
+                "value": "application/json"
+              }
+            ],
+            "url": {
+              "raw": "{{baseUrl}}/binary-contents/00000000-0000-0000-0000-000000000000",
+              "host": ["{{baseUrl}}"],
+              "path": ["binary-contents", "00000000-0000-0000-0000-000000000000"]
+            }
+          },
+          "response": []
+        }
+      ]
+    }
+  ]
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_test_run.json b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_test_run.json
new file mode 100644
index 00000000..93f1dc66
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit API.postman_test_run.json	
@@ -0,0 +1,723 @@
+{
+	"id": "e1564ef8-2dee-477e-86d7-0bf9833a25c2",
+	"name": "Discodeit API",
+	"timestamp": "2026-02-11T04:05:07.759Z",
+	"collection_id": "52123612-55251926-59b1-421c-9a2a-ee03fab096df",
+	"folder_id": 0,
+	"environment_id": "52123612-29d21f93-3998-4caf-b280-05ecc6f4e0de",
+	"totalPass": 25,
+	"delay": 0,
+	"persist": true,
+	"status": "finished",
+	"startedAt": "2026-02-11T04:05:06.896Z",
+	"totalFail": 21,
+	"results": [
+		{
+			"id": "b2d33473-fb38-4502-981e-ea96de84f3c6",
+			"name": "모든 사용자 조회",
+			"url": "http://localhost:8080/users",
+			"time": 16,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"응답은 JSON 배열": true,
+				"사용자 데이터에 필수 필드 포함": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"응답은 JSON 배열": {
+					"pass": 1,
+					"fail": 0
+				},
+				"사용자 데이터에 필수 필드 포함": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				16
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"응답은 JSON 배열": true,
+					"사용자 데이터에 필수 필드 포함": true
+				}
+			]
+		},
+		{
+			"id": "279082f2-cd70-4070-910f-7e7c8421382f",
+			"name": "특정 사용자 조회 (김철수)",
+			"url": "http://localhost:8080/users/10000000-0000-0000-0000-000000000001",
+			"time": 4,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200": false,
+				"응답은 JSON 객체": true,
+				"사용자 ID가 일치": false,
+				"필수 필드 존재": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 0,
+					"fail": 1
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"사용자 ID가 일치": {
+					"pass": 0,
+					"fail": 1
+				},
+				"필수 필드 존재": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": false,
+					"응답은 JSON 객체": true,
+					"사용자 ID가 일치": false,
+					"필수 필드 존재": false
+				}
+			]
+		},
+		{
+			"id": "b14033a0-47cb-4ac9-84e3-1772c8141bfc",
+			"name": "특정 사용자 조회 (이영희)",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"응답은 JSON 객체": true,
+				"사용자 ID가 일치": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"사용자 ID가 일치": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"응답은 JSON 객체": true,
+					"사용자 ID가 일치": true
+				}
+			]
+		},
+		{
+			"id": "39a0f803-5c50-4e94-9baa-b2d6a71ab587",
+			"name": "사용자 생성 (JSON)",
+			"url": "http://localhost:8080/users",
+			"time": 6,
+			"responseCode": {
+				"code": 400,
+				"name": "Bad Request"
+			},
+			"tests": {
+				"상태 코드는 200 또는 201": false,
+				"응답은 JSON 객체": true,
+				"생성된 사용자에 ID 존재": false,
+				"이메일이 요청한 값과 일치": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200 또는 201": {
+					"pass": 0,
+					"fail": 1
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"생성된 사용자에 ID 존재": {
+					"pass": 0,
+					"fail": 1
+				},
+				"이메일이 요청한 값과 일치": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200 또는 201": false,
+					"응답은 JSON 객체": true,
+					"생성된 사용자에 ID 존재": false,
+					"이메일이 요청한 값과 일치": false
+				}
+			]
+		},
+		{
+			"id": "ac47daac-22dd-45db-8ab6-186339b60e6b",
+			"name": "사용자 수정 (김철수)",
+			"url": "http://localhost:8080/users/10000000-0000-0000-0000-000000000001",
+			"time": 6,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200": false,
+				"응답은 JSON 객체": true,
+				"사용자 ID가 유지됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 0,
+					"fail": 1
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"사용자 ID가 유지됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": false,
+					"응답은 JSON 객체": true,
+					"사용자 ID가 유지됨": false
+				}
+			]
+		},
+		{
+			"id": "0becf4c2-9274-4084-ae0c-bf1997917042",
+			"name": "사용자 삭제",
+			"url": "http://localhost:8080/users/10000000-0000-0000-0000-000000000001",
+			"time": 7,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200 또는 204": false,
+				"삭제 성공": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200 또는 204": {
+					"pass": 0,
+					"fail": 1
+				},
+				"삭제 성공": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				7
+			],
+			"allTests": [
+				{
+					"상태 코드는 200 또는 204": false,
+					"삭제 성공": true
+				}
+			]
+		},
+		{
+			"id": "2ca9cb56-2ff5-48af-893a-ddf4144afb58",
+			"name": "김철수 온라인 상태 업데이트",
+			"url": "http://localhost:8080/users/10000000-0000-0000-0000-000000000001/status",
+			"time": 5,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200": false,
+				"응답은 JSON 객체": true,
+				"lastAccessAt 필드가 업데이트됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 0,
+					"fail": 1
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"lastAccessAt 필드가 업데이트됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": false,
+					"응답은 JSON 객체": true,
+					"lastAccessAt 필드가 업데이트됨": false
+				}
+			]
+		},
+		{
+			"id": "728da0e0-bd0b-4983-b147-e0f7d4f604b3",
+			"name": "이영희 온라인 상태 업데이트",
+			"url": "http://localhost:8080/users/20000000-0000-0000-0000-000000000001/status",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"lastAccessAt 필드가 업데이트됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"lastAccessAt 필드가 업데이트됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"lastAccessAt 필드가 업데이트됨": false
+				}
+			]
+		},
+		{
+			"id": "2bf9253e-56b4-41b9-9dc1-9f8a11a051f0",
+			"name": "박민수 온라인 상태 업데이트",
+			"url": "http://localhost:8080/users/30000000-0000-0000-0000-000000000001/status",
+			"time": 9,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"lastAccessAt 필드가 업데이트됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"lastAccessAt 필드가 업데이트됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				9
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"lastAccessAt 필드가 업데이트됨": false
+				}
+			]
+		},
+		{
+			"id": "6027e5fd-58ad-48bc-a623-93033ac3bb33",
+			"name": "최지연 온라인 상태 업데이트",
+			"url": "http://localhost:8080/users/40000000-0000-0000-0000-000000000001/status",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"lastAccessAt 필드가 업데이트됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"lastAccessAt 필드가 업데이트됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"lastAccessAt 필드가 업데이트됨": false
+				}
+			]
+		},
+		{
+			"id": "31c2d1d4-b67d-46c2-bc2a-3aa50bd207e1",
+			"name": "파일 1개 조회 (김철수 프로필)",
+			"url": "http://localhost:8080/binary-contents/10000000-0000-0000-0000-000000000002",
+			"time": 5,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200": false,
+				"응답은 JSON 객체": true,
+				"파일 ID가 일치": false,
+				"필수 필드 존재": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 0,
+					"fail": 1
+				},
+				"응답은 JSON 객체": {
+					"pass": 1,
+					"fail": 0
+				},
+				"파일 ID가 일치": {
+					"pass": 0,
+					"fail": 1
+				},
+				"필수 필드 존재": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": false,
+					"응답은 JSON 객체": true,
+					"파일 ID가 일치": false,
+					"필수 필드 존재": false
+				}
+			]
+		},
+		{
+			"id": "311a6d31-1dd7-4324-83ff-fd062d0c4cd4",
+			"name": "파일 1개 조회 (이영희 프로필)",
+			"url": "http://localhost:8080/binary-contents/20000000-0000-0000-0000-000000000002",
+			"time": 5,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 200": false,
+				"파일 ID가 일치": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 0,
+					"fail": 1
+				},
+				"파일 ID가 일치": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": false,
+					"파일 ID가 일치": false
+				}
+			]
+		},
+		{
+			"id": "bdf9f815-c91c-4824-944e-a8fef290fef2",
+			"name": "파일 여러개 조회 (김철수 + 이영희)",
+			"url": "http://localhost:8080/binary-contents?ids=10000000-0000-0000-0000-000000000002,20000000-0000-0000-0000-000000000002",
+			"time": 8,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"응답은 JSON 배열": true,
+				"2개의 파일 조회됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"응답은 JSON 배열": {
+					"pass": 1,
+					"fail": 0
+				},
+				"2개의 파일 조회됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				8
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"응답은 JSON 배열": true,
+					"2개의 파일 조회됨": false
+				}
+			]
+		},
+		{
+			"id": "c79d76fc-f58d-43b4-a08e-906af1259905",
+			"name": "파일 여러개 조회 (전체)",
+			"url": "http://localhost:8080/binary-contents?ids=10000000-0000-0000-0000-000000000002,20000000-0000-0000-0000-000000000002,30000000-0000-0000-0000-000000000002,40000000-0000-0000-0000-000000000002",
+			"time": 6,
+			"responseCode": {
+				"code": 200,
+				"name": "OK"
+			},
+			"tests": {
+				"상태 코드는 200": true,
+				"응답은 JSON 배열": true,
+				"4개의 파일 조회됨": false
+			},
+			"testPassFailCounts": {
+				"상태 코드는 200": {
+					"pass": 1,
+					"fail": 0
+				},
+				"응답은 JSON 배열": {
+					"pass": 1,
+					"fail": 0
+				},
+				"4개의 파일 조회됨": {
+					"pass": 0,
+					"fail": 1
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 200": true,
+					"응답은 JSON 배열": true,
+					"4개의 파일 조회됨": false
+				}
+			]
+		},
+		{
+			"id": "b88c2929-0801-4dce-a8a6-ce327ad78f5f",
+			"name": "중복 이메일로 사용자 생성 (400 에러)",
+			"url": "http://localhost:8080/users",
+			"time": 5,
+			"responseCode": {
+				"code": 400,
+				"name": "Bad Request"
+			},
+			"tests": {
+				"상태 코드는 400 (Bad Request)": true,
+				"에러 메시지 포함": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 400 (Bad Request)": {
+					"pass": 1,
+					"fail": 0
+				},
+				"에러 메시지 포함": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				5
+			],
+			"allTests": [
+				{
+					"상태 코드는 400 (Bad Request)": true,
+					"에러 메시지 포함": true
+				}
+			]
+		},
+		{
+			"id": "672c6b2e-40e2-4bb1-9560-2590d19021bc",
+			"name": "존재하지 않는 사용자 조회 (404 에러)",
+			"url": "http://localhost:8080/users/00000000-0000-0000-0000-000000000000",
+			"time": 4,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 404 (Not Found)": true,
+				"에러 메시지 포함": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 404 (Not Found)": {
+					"pass": 1,
+					"fail": 0
+				},
+				"에러 메시지 포함": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				4
+			],
+			"allTests": [
+				{
+					"상태 코드는 404 (Not Found)": true,
+					"에러 메시지 포함": true
+				}
+			]
+		},
+		{
+			"id": "245a3ab7-4bec-4eff-9464-d17e18227eef",
+			"name": "존재하지 않는 파일 조회 (404 에러)",
+			"url": "http://localhost:8080/binary-contents/00000000-0000-0000-0000-000000000000",
+			"time": 6,
+			"responseCode": {
+				"code": 404,
+				"name": "Not Found"
+			},
+			"tests": {
+				"상태 코드는 404 (Not Found)": true,
+				"에러 메시지 포함": true
+			},
+			"testPassFailCounts": {
+				"상태 코드는 404 (Not Found)": {
+					"pass": 1,
+					"fail": 0
+				},
+				"에러 메시지 포함": {
+					"pass": 1,
+					"fail": 0
+				}
+			},
+			"times": [
+				6
+			],
+			"allTests": [
+				{
+					"상태 코드는 404 (Not Found)": true,
+					"에러 메시지 포함": true
+				}
+			]
+		}
+	],
+	"count": 1,
+	"totalTime": 110,
+	"collection": {
+		"requests": [
+			{
+				"id": "b2d33473-fb38-4502-981e-ea96de84f3c6",
+				"method": "GET"
+			},
+			{
+				"id": "279082f2-cd70-4070-910f-7e7c8421382f",
+				"method": "GET"
+			},
+			{
+				"id": "b14033a0-47cb-4ac9-84e3-1772c8141bfc",
+				"method": "GET"
+			},
+			{
+				"id": "39a0f803-5c50-4e94-9baa-b2d6a71ab587",
+				"method": "POST"
+			},
+			{
+				"id": "ac47daac-22dd-45db-8ab6-186339b60e6b",
+				"method": "PUT"
+			},
+			{
+				"id": "0becf4c2-9274-4084-ae0c-bf1997917042",
+				"method": "DELETE"
+			},
+			{
+				"id": "2ca9cb56-2ff5-48af-893a-ddf4144afb58",
+				"method": "PUT"
+			},
+			{
+				"id": "728da0e0-bd0b-4983-b147-e0f7d4f604b3",
+				"method": "PUT"
+			},
+			{
+				"id": "2bf9253e-56b4-41b9-9dc1-9f8a11a051f0",
+				"method": "PUT"
+			},
+			{
+				"id": "6027e5fd-58ad-48bc-a623-93033ac3bb33",
+				"method": "PUT"
+			},
+			{
+				"id": "31c2d1d4-b67d-46c2-bc2a-3aa50bd207e1",
+				"method": "GET"
+			},
+			{
+				"id": "311a6d31-1dd7-4324-83ff-fd062d0c4cd4",
+				"method": "GET"
+			},
+			{
+				"id": "bdf9f815-c91c-4824-944e-a8fef290fef2",
+				"method": "GET"
+			},
+			{
+				"id": "c79d76fc-f58d-43b4-a08e-906af1259905",
+				"method": "GET"
+			},
+			{
+				"id": "b88c2929-0801-4dce-a8a6-ce327ad78f5f",
+				"method": "POST"
+			},
+			{
+				"id": "672c6b2e-40e2-4bb1-9560-2590d19021bc",
+				"method": "GET"
+			},
+			{
+				"id": "245a3ab7-4bec-4eff-9464-d17e18227eef",
+				"method": "GET"
+			}
+		]
+	}
+}
\ No newline at end of file
diff --git a/discodeit/src/main/java/com/sprint/mission/docs/Discodeit.postman_environment.json b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit.postman_environment.json
new file mode 100644
index 00000000..9c5d1b84
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/docs/Discodeit.postman_environment.json
@@ -0,0 +1,111 @@
+{
+  "id": "discodeit-environment",
+  "name": "Discodeit Environment",
+  "values": [
+    {
+      "key": "baseUrl",
+      "value": "http://localhost:8080",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Id",
+      "value": "10000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Name",
+      "value": "김철수",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1Email",
+      "value": "kimcs@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user1ProfileId",
+      "value": "10000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Id",
+      "value": "20000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Name",
+      "value": "이영희",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2Email",
+      "value": "leeyh@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user2ProfileId",
+      "value": "20000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Id",
+      "value": "30000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Name",
+      "value": "박민수",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3Email",
+      "value": "parkms@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user3ProfileId",
+      "value": "30000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Id",
+      "value": "40000000-0000-0000-0000-000000000001",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Name",
+      "value": "최지연",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4Email",
+      "value": "choijy@codeit.com",
+      "type": "default",
+      "enabled": true
+    },
+    {
+      "key": "user4ProfileId",
+      "value": "40000000-0000-0000-0000-000000000002",
+      "type": "default",
+      "enabled": true
+    }
+  ],
+  "_postman_variable_scope": "environment",
+  "_postman_exported_at": "2026-02-11T00:33:00.000Z",
+  "_postman_exported_using": "Postman/11.0.0"
+}
diff --git a/discodeit/src/main/java/com/sprint/mission/docs/http-client.env.json b/discodeit/src/main/java/com/sprint/mission/docs/http-client.env.json
new file mode 100644
index 00000000..c226451d
--- /dev/null
+++ b/discodeit/src/main/java/com/sprint/mission/docs/http-client.env.json
@@ -0,0 +1,21 @@
+{
+  "dev": {
+    "baseUrl": "http://localhost:8080",
+    "user1Id": "10000000-0000-0000-0000-000000000001",
+    "user1Name": "김철수",
+    "user1Email": "kimcs@codeit.com",
+    "user1ProfileId": "10000000-0000-0000-0000-000000000002",
+    "user2Id": "20000000-0000-0000-0000-000000000001",
+    "user2Name": "이영희",
+    "user2Email": "leeyh@codeit.com",
+    "user2ProfileId": "20000000-0000-0000-0000-000000000002",
+    "user3Id": "30000000-0000-0000-0000-000000000001",
+    "user3Name": "박민수",
+    "user3Email": "parkms@codeit.com",
+    "user3ProfileId": "30000000-0000-0000-0000-000000000002",
+    "user4Id": "40000000-0000-0000-0000-000000000001",
+    "user4Name": "최지연",
+    "user4Email": "choijy@codeit.com",
+    "user4ProfileId": "40000000-0000-0000-0000-000000000002"
+  }
+}
diff --git "a/discodeit/src/main/java/com/sprint/mission/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\354\240\204 10.58.33.png" "b/discodeit/src/main/java/com/sprint/mission/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\354\240\204 10.58.33.png"
new file mode 100644
index 00000000..d07db6ab
Binary files /dev/null and "b/discodeit/src/main/java/com/sprint/mission/docs/\354\212\244\355\201\254\353\246\260\354\203\267 2026-02-11 \354\230\244\354\240\204 10.58.33.png" differ
diff --git a/discodeit/src/main/resources/data/profiles/choijy.jpg b/discodeit/src/main/resources/data/profiles/choijy.jpg
new file mode 100644
index 00000000..6b42706b
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/choijy.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/choijy.png b/discodeit/src/main/resources/data/profiles/choijy.png
new file mode 100644
index 00000000..f7993c7c
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/choijy.png differ
diff --git a/discodeit/src/main/resources/data/profiles/hansj.jpg b/discodeit/src/main/resources/data/profiles/hansj.jpg
new file mode 100644
index 00000000..9f504c4f
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/hansj.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/janghm.jpg b/discodeit/src/main/resources/data/profiles/janghm.jpg
new file mode 100644
index 00000000..08b0c74d
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/janghm.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/jeonmh.jpg b/discodeit/src/main/resources/data/profiles/jeonmh.jpg
new file mode 100644
index 00000000..d0c45b03
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/jeonmh.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/kimcs.jpg b/discodeit/src/main/resources/data/profiles/kimcs.jpg
new file mode 100644
index 00000000..9f504c4f
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/kimcs.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/kimcs.png b/discodeit/src/main/resources/data/profiles/kimcs.png
new file mode 100644
index 00000000..5c496f25
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/kimcs.png differ
diff --git a/discodeit/src/main/resources/data/profiles/leeyh.jpg b/discodeit/src/main/resources/data/profiles/leeyh.jpg
new file mode 100644
index 00000000..08b0c74d
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/leeyh.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/leeyh.png b/discodeit/src/main/resources/data/profiles/leeyh.png
new file mode 100644
index 00000000..1e6a05d9
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/leeyh.png differ
diff --git a/discodeit/src/main/resources/data/profiles/parkms.jpg b/discodeit/src/main/resources/data/profiles/parkms.jpg
new file mode 100644
index 00000000..d0c45b03
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/parkms.jpg differ
diff --git a/discodeit/src/main/resources/data/profiles/parkms.png b/discodeit/src/main/resources/data/profiles/parkms.png
new file mode 100644
index 00000000..0dd39241
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/parkms.png differ
diff --git a/discodeit/src/main/resources/data/profiles/seohh.jpg b/discodeit/src/main/resources/data/profiles/seohh.jpg
new file mode 100644
index 00000000..6b42706b
Binary files /dev/null and b/discodeit/src/main/resources/data/profiles/seohh.jpg differ
diff --git a/discodeit/src/main/resources/data/users.json b/discodeit/src/main/resources/data/users.json
new file mode 100644
index 00000000..becfab9e
--- /dev/null
+++ b/discodeit/src/main/resources/data/users.json
@@ -0,0 +1,34 @@
+[
+  {
+    "id": "10000000-0000-0000-0000-000000000001",
+    "username": "김철수",
+    "email": "kimcs@codeit.com",
+    "password": "password123",
+    "profileImage": "kimcs.png",
+    "profileId": "10000000-0000-0000-0000-000000000002"
+  },
+  {
+    "id": "20000000-0000-0000-0000-000000000001",
+    "username": "이영희",
+    "email": "leeyh@codeit.com",
+    "password": "password123",
+    "profileImage": "leeyh.png",
+    "profileId": "20000000-0000-0000-0000-000000000002"
+  },
+  {
+    "id": "30000000-0000-0000-0000-000000000001",
+    "username": "박민수",
+    "email": "parkms@codeit.com",
+    "password": "password123",
+    "profileImage": "parkms.png",
+    "profileId": "30000000-0000-0000-0000-000000000002"
+  },
+  {
+    "id": "40000000-0000-0000-0000-000000000001",
+    "username": "최지연",
+    "email": "choijy@codeit.com",
+    "password": "password123",
+    "profileImage": "choijy.png",
+    "profileId": "40000000-0000-0000-0000-000000000002"
+  }
+]
diff --git a/discodeit/src/main/resources/static/index.html b/discodeit/src/main/resources/static/index.html
new file mode 100644
index 00000000..6eb6f3af
--- /dev/null
+++ b/discodeit/src/main/resources/static/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta http-equiv="refresh" content="0; url=/user-list.html">
+    <title>Discodeit</title>
+</head>
+<body>
+    <script>
+        window.location.href = '/user-list.html';
+    </script>
+</body>
+</html>
diff --git a/discodeit/src/main/resources/static/script.js b/discodeit/src/main/resources/static/script.js
new file mode 100644
index 00000000..f1c0c9af
--- /dev/null
+++ b/discodeit/src/main/resources/static/script.js
@@ -0,0 +1,107 @@
+// API endpoints
+const ENDPOINTS = {
+    USERS: '/users'
+};
+
+// Initialize the application
+document.addEventListener('DOMContentLoaded', () => {
+    fetchAndRenderUsers();
+});
+
+// Fetch users from the API
+async function fetchAndRenderUsers() {
+    try {
+        const response = await fetch(ENDPOINTS.USERS);
+        if (!response.ok) throw new Error('Failed to fetch users');
+        const users = await response.json();
+        renderUserList(users);
+    } catch (error) {
+        console.error('Error fetching users:', error);
+    }
+}
+
+// Fetch user profile image
+async function fetchUserProfile(profileId) {
+    try {
+        const response = await fetch(`/binary-contents/${profileId}`);
+        if (!response.ok) throw new Error('Failed to fetch profile');
+        const profile = await response.json();
+
+        // Data is already base64 encoded string
+        return `data:${profile.contentType};base64,${profile.data}`;
+    } catch (error) {
+        console.error('Error fetching profile:', error);
+        return '/default-avatar.png'; // Fallback to default avatar
+    }
+}
+
+// Render user list
+async function renderUserList(users) {
+    const userListElement = document.getElementById('userList');
+    userListElement.innerHTML = ''; // Clear existing content
+
+    if (users.length === 0) {
+        userListElement.innerHTML = '<p style="color: white; text-align: center; padding: 40px;">등록된 사용자가 없습니다.</p>';
+        return;
+    }
+
+    for (const user of users) {
+        const userElement = document.createElement('div');
+        userElement.className = 'user-item';
+
+        // Get profile image URL
+        const profileUrl = user.profileId ?
+            await fetchUserProfile(user.profileId) :
+            '/default-avatar.png';
+
+        userElement.innerHTML = `
+            <div class="user-content">
+                <img src="${profileUrl}" alt="${user.username}" class="user-avatar">
+                <div class="user-info">
+                    <div class="user-name">${user.username}</div>
+                    <div class="user-email">${user.email}</div>
+                </div>
+                <div class="status-badge ${user.online ? 'online' : 'offline'}">
+                    ${user.online ? '온라인' : '오프라인'}
+                </div>
+            </div>
+            <div class="user-actions">
+                <button class="btn btn-edit" onclick="editUser('${user.id}')">✏️ 수정</button>
+                <button class="btn btn-delete" onclick="deleteUser('${user.id}', '${user.username}')">🗑️ 삭제</button>
+            </div>
+        `;
+
+        userListElement.appendChild(userElement);
+    }
+}
+
+// Edit user
+function editUser(userId) {
+    window.location.href = `/user-edit.html?id=${userId}`;
+}
+
+// Delete user
+async function deleteUser(userId, username) {
+    if (!confirm(`정말로 "${username}" 사용자를 삭제하시겠습니까?`)) {
+        return;
+    }
+
+    try {
+        const response = await fetch(`/users/${userId}`, {
+            method: 'DELETE'
+        });
+
+        if (!response.ok) {
+            throw new Error(`Failed to delete user: ${response.status}`);
+        }
+
+        alert('✅ 사용자가 삭제되었습니다.');
+
+        // Reload user list
+        fetchAndRenderUsers();
+
+    } catch (error) {
+        console.error('Error deleting user:', error);
+        alert('❌ 사용자 삭제 실패: ' + error.message);
+    }
+}
diff --git a/discodeit/src/main/resources/static/styles.css b/discodeit/src/main/resources/static/styles.css
new file mode 100644
index 00000000..57a53d2d
--- /dev/null
+++ b/discodeit/src/main/resources/static/styles.css
@@ -0,0 +1,80 @@
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    font-family: Arial, sans-serif;
+    background-color: #f5f5f5;
+}
+
+.container {
+    max-width: 800px;
+    margin: 0 auto;
+    padding: 20px;
+}
+
+h1 {
+    text-align: center;
+    margin-bottom: 30px;
+    color: #333;
+}
+
+.user-list {
+    background-color: white;
+    border-radius: 8px;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+}
+
+.user-item {
+    display: flex;
+    align-items: center;
+    padding: 20px;
+    border-bottom: 1px solid #eee;
+}
+
+.user-item:last-child {
+    border-bottom: none;
+}
+
+.user-avatar {
+    width: 60px;
+    height: 60px;
+    border-radius: 50%;
+    margin-right: 20px;
+    object-fit: cover;
+}
+
+.user-info {
+    flex-grow: 1;
+}
+
+.user-name {
+    font-size: 18px;
+    font-weight: bold;
+    color: #333;
+    margin-bottom: 5px;
+}
+
+.user-email {
+    font-size: 14px;
+    color: #666;
+}
+
+.status-badge {
+    padding: 6px 12px;
+    border-radius: 20px;
+    font-size: 14px;
+    font-weight: bold;
+}
+
+.online {
+    background-color: #4CAF50;
+    color: white;
+}
+
+.offline {
+    background-color: #9e9e9e;
+    color: white;
+}
diff --git a/discodeit/src/main/resources/static/user-create.html b/discodeit/src/main/resources/static/user-create.html
new file mode 100644
index 00000000..ed3ad0b8
--- /dev/null
+++ b/discodeit/src/main/resources/static/user-create.html
@@ -0,0 +1,409 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>사용자 등록</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            padding: 40px 20px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+
+        .container {
+            max-width: 500px;
+            width: 100%;
+        }
+
+        .card {
+            background: white;
+            border-radius: 20px;
+            padding: 40px;
+            box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+        }
+
+        h1 {
+            color: #1a202c;
+            text-align: center;
+            margin-bottom: 10px;
+            font-size: 2rem;
+        }
+
+        .subtitle {
+            text-align: center;
+            color: #718096;
+            margin-bottom: 30px;
+            font-size: 0.95rem;
+        }
+
+        .form-group {
+            margin-bottom: 24px;
+        }
+
+        label {
+            display: block;
+            color: #2d3748;
+            font-weight: 600;
+            margin-bottom: 8px;
+            font-size: 0.95rem;
+        }
+
+        .required {
+            color: #e53e3e;
+        }
+
+        input[type="text"],
+        input[type="email"],
+        input[type="password"] {
+            width: 100%;
+            padding: 12px 16px;
+            border: 2px solid #e2e8f0;
+            border-radius: 10px;
+            font-size: 1rem;
+            transition: all 0.3s ease;
+            background: white;
+        }
+
+        input:focus {
+            outline: none;
+            border-color: #667eea;
+            box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.1);
+        }
+
+        input::placeholder {
+            color: #cbd5e0;
+        }
+
+        .file-input-wrapper {
+            position: relative;
+            overflow: hidden;
+            display: inline-block;
+            width: 100%;
+        }
+
+        .file-input-label {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 10px;
+            padding: 12px 16px;
+            border: 2px dashed #cbd5e0;
+            border-radius: 10px;
+            background: #f7fafc;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            color: #4a5568;
+            font-weight: 500;
+        }
+
+        .file-input-label:hover {
+            border-color: #667eea;
+            background: #edf2f7;
+            color: #667eea;
+        }
+
+        input[type="file"] {
+            position: absolute;
+            left: -9999px;
+        }
+
+        .file-name {
+            margin-top: 8px;
+            color: #718096;
+            font-size: 0.875rem;
+            text-align: center;
+        }
+
+        .preview-container {
+            margin-top: 16px;
+            text-align: center;
+        }
+
+        .preview-image {
+            max-width: 150px;
+            max-height: 150px;
+            border-radius: 10px;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+            display: none;
+        }
+
+        .btn-group {
+            display: flex;
+            gap: 12px;
+            margin-top: 32px;
+        }
+
+        button {
+            flex: 1;
+            padding: 14px 24px;
+            border: none;
+            border-radius: 10px;
+            font-size: 1rem;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+
+        .btn-primary {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+        }
+
+        .btn-primary:hover:not(:disabled) {
+            transform: translateY(-2px);
+            box-shadow: 0 8px 20px rgba(102, 126, 234, 0.4);
+        }
+
+        .btn-primary:disabled {
+            opacity: 0.6;
+            cursor: not-allowed;
+        }
+
+        .btn-secondary {
+            background: #e2e8f0;
+            color: #2d3748;
+        }
+
+        .btn-secondary:hover {
+            background: #cbd5e0;
+        }
+
+        .alert {
+            padding: 14px 18px;
+            border-radius: 10px;
+            margin-bottom: 24px;
+            font-size: 0.95rem;
+            display: none;
+        }
+
+        .alert-success {
+            background: #c6f6d5;
+            color: #22543d;
+            border: 1px solid #9ae6b4;
+        }
+
+        .alert-error {
+            background: #fed7d7;
+            color: #742a2a;
+            border: 1px solid #fc8181;
+        }
+
+        .loading-spinner {
+            display: inline-block;
+            width: 16px;
+            height: 16px;
+            border: 3px solid rgba(255,255,255,0.3);
+            border-radius: 50%;
+            border-top-color: white;
+            animation: spin 0.8s linear infinite;
+        }
+
+        @keyframes spin {
+            to { transform: rotate(360deg); }
+        }
+
+        .help-text {
+            margin-top: 6px;
+            color: #718096;
+            font-size: 0.85rem;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="card">
+            <h1>👤 사용자 등록</h1>
+            <p class="subtitle">새로운 사용자를 등록합니다</p>
+
+            <div id="alert" class="alert"></div>
+
+            <form id="userForm" enctype="multipart/form-data">
+                <div class="form-group">
+                    <label for="username">
+                        사용자명 <span class="required">*</span>
+                    </label>
+                    <input
+                        type="text"
+                        id="username"
+                        name="username"
+                        placeholder="사용자명을 입력하세요"
+                        required
+                    />
+                </div>
+
+                <div class="form-group">
+                    <label for="email">
+                        이메일 <span class="required">*</span>
+                    </label>
+                    <input
+                        type="email"
+                        id="email"
+                        name="email"
+                        placeholder="example@email.com"
+                        required
+                    />
+                </div>
+
+                <div class="form-group">
+                    <label for="password">
+                        비밀번호 <span class="required">*</span>
+                    </label>
+                    <input
+                        type="password"
+                        id="password"
+                        name="password"
+                        placeholder="비밀번호를 입력하세요"
+                        required
+                    />
+                    <p class="help-text">최소 6자 이상 입력하세요</p>
+                </div>
+
+                <div class="form-group">
+                    <label for="profileImage">
+                        프로필 이미지 (선택)
+                    </label>
+                    <div class="file-input-wrapper">
+                        <label for="profileImage" class="file-input-label">
+                            📷 이미지 선택
+                        </label>
+                        <input
+                            type="file"
+                            id="profileImage"
+                            name="profileImage"
+                            accept="image/*"
+                        />
+                    </div>
+                    <p class="file-name" id="fileName">선택된 파일 없음</p>
+                    <div class="preview-container">
+                        <img id="preview" class="preview-image" alt="미리보기" />
+                    </div>
+                </div>
+
+                <div class="btn-group">
+                    <button type="button" class="btn-secondary" onclick="goBack()">
+                        취소
+                    </button>
+                    <button type="submit" class="btn-primary" id="submitBtn">
+                        등록하기
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <script>
+        const form = document.getElementById('userForm');
+        const profileImageInput = document.getElementById('profileImage');
+        const fileNameDisplay = document.getElementById('fileName');
+        const previewImage = document.getElementById('preview');
+        const submitBtn = document.getElementById('submitBtn');
+        const alertBox = document.getElementById('alert');
+
+        // 파일 선택 시 미리보기
+        profileImageInput.addEventListener('change', function(e) {
+            const file = e.target.files[0];
+
+            if (file) {
+                fileNameDisplay.textContent = file.name;
+
+                // 이미지 미리보기
+                const reader = new FileReader();
+                reader.onload = function(e) {
+                    previewImage.src = e.target.result;
+                    previewImage.style.display = 'block';
+                };
+                reader.readAsDataURL(file);
+            } else {
+                fileNameDisplay.textContent = '선택된 파일 없음';
+                previewImage.style.display = 'none';
+            }
+        });
+
+        // 폼 제출
+        form.addEventListener('submit', async function(e) {
+            e.preventDefault();
+
+            // 비밀번호 검증
+            const password = document.getElementById('password').value;
+            if (password.length < 6) {
+                showAlert('비밀번호는 최소 6자 이상이어야 합니다.', 'error');
+                return;
+            }
+
+            // 버튼 비활성화 및 로딩 표시
+            submitBtn.disabled = true;
+            submitBtn.innerHTML = '<span class="loading-spinner"></span> 등록 중...';
+
+            try {
+                // FormData 생성
+                const formData = new FormData();
+                formData.append('username', document.getElementById('username').value);
+                formData.append('email', document.getElementById('email').value);
+                formData.append('password', password);
+
+                // 프로필 이미지가 있으면 추가
+                const profileFile = profileImageInput.files[0];
+                if (profileFile) {
+                    formData.append('profileImage', profileFile);
+                }
+
+                // API 호출
+                const response = await fetch('/users/with-profile', {
+                    method: 'POST',
+                    body: formData
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json().catch(() => ({}));
+                    throw new Error(errorData.message || `HTTP error! status: ${response.status}`);
+                }
+
+                const user = await response.json();
+
+                showAlert('✅ 사용자가 성공적으로 등록되었습니다!', 'success');
+
+                // 2초 후 사용자 목록 페이지로 이동
+                setTimeout(() => {
+                    window.location.href = '/user-list.html';
+                }, 2000);
+
+            } catch (error) {
+                console.error('Error creating user:', error);
+                showAlert('❌ 사용자 등록 실패: ' + error.message, 'error');
+
+                // 버튼 다시 활성화
+                submitBtn.disabled = false;
+                submitBtn.textContent = '등록하기';
+            }
+        });
+
+        function showAlert(message, type) {
+            alertBox.textContent = message;
+            alertBox.className = 'alert alert-' + type;
+            alertBox.style.display = 'block';
+
+            // 성공 메시지는 자동으로 사라지지 않음
+            if (type === 'error') {
+                setTimeout(() => {
+                    alertBox.style.display = 'none';
+                }, 5000);
+            }
+        }
+
+        function goBack() {
+            window.history.back();
+        }
+    </script>
+</body>
+</html>
diff --git a/discodeit/src/main/resources/static/user-edit.html b/discodeit/src/main/resources/static/user-edit.html
new file mode 100644
index 00000000..13b913f7
--- /dev/null
+++ b/discodeit/src/main/resources/static/user-edit.html
@@ -0,0 +1,498 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>사용자 정보 수정</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            padding: 40px 20px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+
+        .container {
+            max-width: 500px;
+            width: 100%;
+        }
+
+        .card {
+            background: white;
+            border-radius: 20px;
+            padding: 40px;
+            box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+        }
+
+        h1 {
+            color: #1a202c;
+            text-align: center;
+            margin-bottom: 10px;
+            font-size: 2rem;
+        }
+
+        .subtitle {
+            text-align: center;
+            color: #718096;
+            margin-bottom: 30px;
+            font-size: 0.95rem;
+        }
+
+        .form-group {
+            margin-bottom: 24px;
+        }
+
+        label {
+            display: block;
+            color: #2d3748;
+            font-weight: 600;
+            margin-bottom: 8px;
+            font-size: 0.95rem;
+        }
+
+        .required {
+            color: #e53e3e;
+        }
+
+        input[type="text"],
+        input[type="email"],
+        input[type="password"] {
+            width: 100%;
+            padding: 12px 16px;
+            border: 2px solid #e2e8f0;
+            border-radius: 10px;
+            font-size: 1rem;
+            transition: all 0.3s ease;
+            background: white;
+        }
+
+        input:focus {
+            outline: none;
+            border-color: #667eea;
+            box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.1);
+        }
+
+        input::placeholder {
+            color: #cbd5e0;
+        }
+
+        .current-profile {
+            margin-bottom: 16px;
+            text-align: center;
+        }
+
+        .current-profile img {
+            width: 120px;
+            height: 120px;
+            border-radius: 50%;
+            object-fit: cover;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+        }
+
+        .current-profile-text {
+            margin-top: 8px;
+            color: #718096;
+            font-size: 0.875rem;
+        }
+
+        .file-input-wrapper {
+            position: relative;
+            overflow: hidden;
+            display: inline-block;
+            width: 100%;
+        }
+
+        .file-input-label {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 10px;
+            padding: 12px 16px;
+            border: 2px dashed #cbd5e0;
+            border-radius: 10px;
+            background: #f7fafc;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            color: #4a5568;
+            font-weight: 500;
+        }
+
+        .file-input-label:hover {
+            border-color: #667eea;
+            background: #edf2f7;
+            color: #667eea;
+        }
+
+        input[type="file"] {
+            position: absolute;
+            left: -9999px;
+        }
+
+        .file-name {
+            margin-top: 8px;
+            color: #718096;
+            font-size: 0.875rem;
+            text-align: center;
+        }
+
+        .preview-container {
+            margin-top: 16px;
+            text-align: center;
+        }
+
+        .preview-image {
+            max-width: 150px;
+            max-height: 150px;
+            border-radius: 10px;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+            display: none;
+        }
+
+        .btn-group {
+            display: flex;
+            gap: 12px;
+            margin-top: 32px;
+        }
+
+        button {
+            flex: 1;
+            padding: 14px 24px;
+            border: none;
+            border-radius: 10px;
+            font-size: 1rem;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.3s ease;
+        }
+
+        .btn-primary {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+        }
+
+        .btn-primary:hover:not(:disabled) {
+            transform: translateY(-2px);
+            box-shadow: 0 8px 20px rgba(102, 126, 234, 0.4);
+        }
+
+        .btn-primary:disabled {
+            opacity: 0.6;
+            cursor: not-allowed;
+        }
+
+        .btn-secondary {
+            background: #e2e8f0;
+            color: #2d3748;
+        }
+
+        .btn-secondary:hover {
+            background: #cbd5e0;
+        }
+
+        .alert {
+            padding: 14px 18px;
+            border-radius: 10px;
+            margin-bottom: 24px;
+            font-size: 0.95rem;
+            display: none;
+        }
+
+        .alert-success {
+            background: #c6f6d5;
+            color: #22543d;
+            border: 1px solid #9ae6b4;
+        }
+
+        .alert-error {
+            background: #fed7d7;
+            color: #742a2a;
+            border: 1px solid #fc8181;
+        }
+
+        .loading-spinner {
+            display: inline-block;
+            width: 16px;
+            height: 16px;
+            border: 3px solid rgba(255,255,255,0.3);
+            border-radius: 50%;
+            border-top-color: white;
+            animation: spin 0.8s linear infinite;
+        }
+
+        @keyframes spin {
+            to { transform: rotate(360deg); }
+        }
+
+        .help-text {
+            margin-top: 6px;
+            color: #718096;
+            font-size: 0.85rem;
+        }
+
+        .loading-page {
+            text-align: center;
+            color: white;
+            padding: 40px;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="card">
+            <div id="loadingPage" class="loading-page">
+                <div class="loading-spinner" style="border-color: #667eea; border-top-color: transparent; width: 40px; height: 40px; margin: 0 auto 16px;"></div>
+                <p>사용자 정보를 불러오는 중...</p>
+            </div>
+
+            <div id="editForm" style="display: none;">
+                <h1>✏️ 사용자 정보 수정</h1>
+                <p class="subtitle">사용자 정보를 수정합니다</p>
+
+                <div id="alert" class="alert"></div>
+
+                <form id="userForm" enctype="multipart/form-data">
+                    <div class="form-group">
+                        <label>현재 프로필 이미지</label>
+                        <div class="current-profile">
+                            <img id="currentProfile" src="/default-avatar.png" alt="현재 프로필">
+                            <p class="current-profile-text" id="profileText">프로필 이미지 없음</p>
+                        </div>
+                    </div>
+
+                    <div class="form-group">
+                        <label for="username">
+                            사용자명 <span class="required">*</span>
+                        </label>
+                        <input
+                            type="text"
+                            id="username"
+                            name="username"
+                            placeholder="사용자명을 입력하세요"
+                            required
+                        />
+                    </div>
+
+                    <div class="form-group">
+                        <label for="email">
+                            이메일 <span class="required">*</span>
+                        </label>
+                        <input
+                            type="email"
+                            id="email"
+                            name="email"
+                            placeholder="example@email.com"
+                            required
+                        />
+                    </div>
+
+                    <div class="form-group">
+                        <label for="password">
+                            비밀번호 <span class="required">*</span>
+                        </label>
+                        <input
+                            type="password"
+                            id="password"
+                            name="password"
+                            placeholder="비밀번호를 입력하세요"
+                            required
+                        />
+                        <p class="help-text">최소 6자 이상 입력하세요</p>
+                    </div>
+
+                    <div class="form-group">
+                        <label for="profileImage">
+                            새 프로필 이미지 (선택)
+                        </label>
+                        <div class="file-input-wrapper">
+                            <label for="profileImage" class="file-input-label">
+                                📷 새 이미지 선택
+                            </label>
+                            <input
+                                type="file"
+                                id="profileImage"
+                                name="profileImage"
+                                accept="image/*"
+                            />
+                        </div>
+                        <p class="file-name" id="fileName">선택된 파일 없음</p>
+                        <div class="preview-container">
+                            <img id="preview" class="preview-image" alt="미리보기" />
+                        </div>
+                    </div>
+
+                    <div class="btn-group">
+                        <button type="button" class="btn-secondary" onclick="goBack()">
+                            취소
+                        </button>
+                        <button type="submit" class="btn-primary" id="submitBtn">
+                            수정하기
+                        </button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        let userId = null;
+        let currentUser = null;
+
+        const form = document.getElementById('userForm');
+        const profileImageInput = document.getElementById('profileImage');
+        const fileNameDisplay = document.getElementById('fileName');
+        const previewImage = document.getElementById('preview');
+        const submitBtn = document.getElementById('submitBtn');
+        const alertBox = document.getElementById('alert');
+
+        // Get user ID from URL
+        const urlParams = new URLSearchParams(window.location.search);
+        userId = urlParams.get('id');
+
+        if (!userId) {
+            alert('사용자 ID가 없습니다.');
+            window.location.href = '/user-list.html';
+        }
+
+        // Load user data
+        async function loadUserData() {
+            try {
+                const response = await fetch(`/users/${userId}`);
+                if (!response.ok) throw new Error('사용자를 찾을 수 없습니다.');
+
+                currentUser = await response.json();
+
+                // Fill form with current data
+                document.getElementById('username').value = currentUser.username;
+                document.getElementById('email').value = currentUser.email;
+
+                // Load profile image if exists
+                if (currentUser.profileId) {
+                    const profileResponse = await fetch(`/binary-contents/${currentUser.profileId}`);
+                    if (profileResponse.ok) {
+                        const profile = await profileResponse.json();
+                        const profileUrl = `data:${profile.contentType};base64,${profile.data}`;
+                        document.getElementById('currentProfile').src = profileUrl;
+                        document.getElementById('profileText').textContent = '현재 프로필 이미지';
+                    }
+                }
+
+                // Show form, hide loading
+                document.getElementById('loadingPage').style.display = 'none';
+                document.getElementById('editForm').style.display = 'block';
+
+            } catch (error) {
+                console.error('Error loading user:', error);
+                alert('사용자 정보를 불러올 수 없습니다: ' + error.message);
+                window.location.href = '/user-list.html';
+            }
+        }
+
+        // Load user data on page load
+        loadUserData();
+
+        // 파일 선택 시 미리보기
+        profileImageInput.addEventListener('change', function(e) {
+            const file = e.target.files[0];
+
+            if (file) {
+                fileNameDisplay.textContent = file.name;
+
+                // 이미지 미리보기
+                const reader = new FileReader();
+                reader.onload = function(e) {
+                    previewImage.src = e.target.result;
+                    previewImage.style.display = 'block';
+                };
+                reader.readAsDataURL(file);
+            } else {
+                fileNameDisplay.textContent = '선택된 파일 없음';
+                previewImage.style.display = 'none';
+            }
+        });
+
+        // 폼 제출
+        form.addEventListener('submit', async function(e) {
+            e.preventDefault();
+
+            // 비밀번호 검증
+            const password = document.getElementById('password').value;
+            if (password.length < 6) {
+                showAlert('비밀번호는 최소 6자 이상이어야 합니다.', 'error');
+                return;
+            }
+
+            // 버튼 비활성화 및 로딩 표시
+            submitBtn.disabled = true;
+            submitBtn.innerHTML = '<span class="loading-spinner"></span> 수정 중...';
+
+            try {
+                // FormData 생성
+                const formData = new FormData();
+                formData.append('username', document.getElementById('username').value);
+                formData.append('email', document.getElementById('email').value);
+                formData.append('password', password);
+
+                // 프로필 이미지가 있으면 추가
+                const profileFile = profileImageInput.files[0];
+                if (profileFile) {
+                    formData.append('profileImage', profileFile);
+                }
+
+                // API 호출
+                const response = await fetch(`/users/${userId}/with-profile`, {
+                    method: 'PUT',
+                    body: formData
+                });
+
+                if (!response.ok) {
+                    const errorData = await response.json().catch(() => ({}));
+                    throw new Error(errorData.message || `HTTP error! status: ${response.status}`);
+                }
+
+                const user = await response.json();
+
+                showAlert('✅ 사용자 정보가 성공적으로 수정되었습니다!', 'success');
+
+                // 2초 후 사용자 목록 페이지로 이동
+                setTimeout(() => {
+                    window.location.href = '/user-list.html';
+                }, 2000);
+
+            } catch (error) {
+                console.error('Error updating user:', error);
+                showAlert('❌ 사용자 정보 수정 실패: ' + error.message, 'error');
+
+                // 버튼 다시 활성화
+                submitBtn.disabled = false;
+                submitBtn.textContent = '수정하기';
+            }
+        });
+
+        function showAlert(message, type) {
+            alertBox.textContent = message;
+            alertBox.className = 'alert alert-' + type;
+            alertBox.style.display = 'block';
+
+            // 성공 메시지는 자동으로 사라지지 않음
+            if (type === 'error') {
+                setTimeout(() => {
+                    alertBox.style.display = 'none';
+                }, 5000);
+            }
+        }
+
+        function goBack() {
+            window.location.href = '/user-list.html';
+        }
+    </script>
+</body>
+</html>
diff --git a/discodeit/src/main/resources/static/user-list.html b/discodeit/src/main/resources/static/user-list.html
new file mode 100644
index 00000000..738218e2
--- /dev/null
+++ b/discodeit/src/main/resources/static/user-list.html
@@ -0,0 +1,264 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>사용자 목록</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: #E5E7EB;
+            min-height: 100vh;
+            padding: 40px 20px;
+        }
+
+        .container {
+            max-width: 1000px;
+            margin: 0 auto;
+        }
+
+        .header {
+            text-align: center;
+            margin-bottom: 40px;
+        }
+
+        h1 {
+            color: #1a202c;
+            font-size: 2rem;
+            margin: 0;
+            font-weight: 600;
+        }
+
+        .user-list {
+            background: white;
+            border-radius: 16px;
+            overflow: hidden;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+        }
+
+        .user-item {
+            background: white;
+            padding: 24px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            gap: 16px;
+            border-bottom: 1px solid #E5E7EB;
+        }
+
+        .user-item:last-child {
+            border-bottom: none;
+        }
+
+        .user-item:hover {
+            background: #F9FAFB;
+        }
+
+        .user-content {
+            display: flex;
+            align-items: center;
+            gap: 16px;
+            flex: 1;
+        }
+
+        .user-avatar {
+            width: 60px;
+            height: 60px;
+            border-radius: 50%;
+            object-fit: cover;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+            font-size: 24px;
+            font-weight: bold;
+            flex-shrink: 0;
+        }
+
+        .user-info {
+            flex: 1;
+            min-width: 0;
+        }
+
+        .user-name {
+            font-size: 1.125rem;
+            font-weight: 600;
+            color: #1a202c;
+            margin-bottom: 4px;
+        }
+
+        .user-email {
+            color: #718096;
+            font-size: 0.875rem;
+        }
+
+        .status-badge {
+            padding: 8px 20px;
+            border-radius: 20px;
+            font-size: 0.875rem;
+            font-weight: 600;
+            flex-shrink: 0;
+        }
+
+        .status-badge.online {
+            background-color: #48BB78;
+            color: white;
+        }
+
+        .status-badge.offline {
+            background-color: #CBD5E0;
+            color: #4A5568;
+        }
+
+        .loading {
+            text-align: center;
+            color: #4A5568;
+            font-size: 1.5rem;
+            padding: 60px 0;
+        }
+
+        .error {
+            background: #fff5f5;
+            border: 2px solid #fc8181;
+            border-radius: 12px;
+            padding: 24px;
+            text-align: center;
+            color: #742a2a;
+        }
+    </style>
+</head>
+<body>
+<div class="container">
+    <div class="header">
+        <h1>사용자 목록</h1>
+    </div>
+    <div id="loading" class="loading">
+        로딩 중...
+    </div>
+    <div id="error" class="error" style="display: none;"></div>
+    <div class="user-list" id="userList">
+        <!-- Users will be dynamically inserted here -->
+    </div>
+</div>
+<script>
+    // Fetch user profile image
+    async function fetchUserProfile(profileId) {
+        try {
+            console.log('Fetching profile:', profileId);
+            const response = await fetch(`/binary-contents/${profileId}`);
+            if (!response.ok) {
+                console.error('Profile fetch failed:', response.status, response.statusText);
+                throw new Error('Failed to fetch profile');
+            }
+            const profile = await response.json();
+            console.log('Profile data received:', {
+                contentType: profile.contentType,
+                dataLength: profile.data ? profile.data.length : 0
+            });
+
+            if (!profile.data) {
+                console.error('No data in profile');
+                return null;
+            }
+
+            return `data:${profile.contentType};base64,${profile.data}`;
+        } catch (error) {
+            console.error('Error fetching profile:', profileId, error);
+            return null;
+        }
+    }
+
+    // 사용자 이름에 따라 성별 판단
+    function getGenderByName(username) {
+        const maleNames = ['김철수', '박민수', 'rex', 'buzz', 'woody'];
+        const femaleNames = ['이영희', '최지연', 'jessie'];
+
+        if (maleNames.includes(username)) return 'male';
+        if (femaleNames.includes(username)) return 'female';
+        return 'male'; // 기본값
+    }
+
+    // 성별에 따라 아바타 이미지 URL 생성 (DiceBear API 사용)
+    function getAvatarUrl(username, gender) {
+        const seed = encodeURIComponent(username);
+        if (gender === 'male') {
+            return `https://api.dicebear.com/7.x/avataaars/svg?seed=${seed}&backgroundColor=b6e3f4&radius=50`;
+        } else {
+            return `https://api.dicebear.com/7.x/avataaars/svg?seed=${seed}&backgroundColor=ffd5dc&radius=50`;
+        }
+    }
+
+    async function loadUsers() {
+        const loading = document.getElementById('loading');
+        const error = document.getElementById('error');
+        const userList = document.getElementById('userList');
+
+        try {
+            const response = await fetch('/users');
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+
+            const users = await response.json();
+            loading.style.display = 'none';
+
+            if (users.length === 0) {
+                userList.innerHTML = '<div style="text-align: center; color: #4A5568; padding: 60px 0;"><h2>등록된 사용자가 없습니다</h2></div>';
+                return;
+            }
+
+            // Create user cards
+            const userCards = await Promise.all(users.map(async user => {
+                const gender = getGenderByName(user.username);
+
+                let avatarHtml = '';
+                if (user.profileId) {
+                    const profileUrl = await fetchUserProfile(user.profileId);
+                    if (profileUrl) {
+                        avatarHtml = `<img src="${profileUrl}" alt="${user.username}" class="user-avatar">`;
+                    } else {
+                        const avatarUrl = getAvatarUrl(user.username, gender);
+                        avatarHtml = `<img src="${avatarUrl}" alt="${user.username}" class="user-avatar">`;
+                    }
+                } else {
+                    const avatarUrl = getAvatarUrl(user.username, gender);
+                    avatarHtml = `<img src="${avatarUrl}" alt="${user.username}" class="user-avatar">`;
+                }
+
+                return `
+                    <div class="user-item">
+                        <div class="user-content">
+                            ${avatarHtml}
+                            <div class="user-info">
+                                <div class="user-name">${user.username}</div>
+                                <div class="user-email">${user.email}</div>
+                            </div>
+                        </div>
+                        <div class="status-badge ${user.online ? 'online' : 'offline'}">
+                            ${user.online ? '온라인' : '오프라인'}
+                        </div>
+                    </div>
+                `;
+            }));
+
+            userList.innerHTML = userCards.join('');
+        } catch (err) {
+            loading.style.display = 'none';
+            error.style.display = 'block';
+            error.textContent = `사용자 목록을 불러오는데 실패했습니다: ${err.message}`;
+            console.error('Error loading users:', err);
+        }
+    }
+
+    // 페이지 로드 시 사용자 목록 불러오기
+    loadUsers();
+</script>
+</body>
+</html>
diff --git a/discodeit/src/test/java/com/sprint/mission/discodeit/service/FunctionalTest.java b/discodeit/src/test/java/com/sprint/mission/discodeit/service/FunctionalTest.java
new file mode 100644
index 00000000..b2b35d0f
--- /dev/null
+++ b/discodeit/src/test/java/com/sprint/mission/discodeit/service/FunctionalTest.java
@@ -0,0 +1,729 @@
+package com.sprint.mission.discodeit.service;
+
+import com.sprint.mission.discodeit.dto.request.*;
+import com.sprint.mission.discodeit.dto.response.ChannelResponse;
+import com.sprint.mission.discodeit.dto.response.MessageResponse;
+import com.sprint.mission.discodeit.dto.response.UserResponse;
+import com.sprint.mission.discodeit.entity.BinaryContent;
+import com.sprint.mission.discodeit.entity.ReadStatus;
+import com.sprint.mission.discodeit.entity.UserStatus;
+import com.sprint.mission.discodeit.repository.jcf.*;
+import com.sprint.mission.discodeit.service.basic.*;
+
+import java.io.FileWriter;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+import java.util.UUID;
+
+/**
+ * 기능 테스트 - 콘솔 및 파일 출력
+ *
+ * 모든 요구사항 기능을 테스트하고 결과를 콘솔과 파일에 출력합니다.
+ */
+public class FunctionalTest {
+
+    // Repositories
+    private final JCFUserRepository userRepository;
+    private final JCFUserStatusRepository userStatusRepository;
+    private final JCFBinaryContentRepository binaryContentRepository;
+    private final JCFChannelRepository channelRepository;
+    private final JCFMessageRepository messageRepository;
+    private final JCFReadStatusRepository readStatusRepository;
+
+    // Services
+    private final UserService userService;
+    private final AuthService authService;
+    private final UserStatusService userStatusService;
+    private final ChannelService channelService;
+    private final MessageService messageService;
+    private final ReadStatusService readStatusService;
+    private final BinaryContentService binaryContentService;
+
+    // Output
+    private final StringBuilder outputBuffer;
+    private int testCount = 0;
+    private int passCount = 0;
+    private int failCount = 0;
+
+    public FunctionalTest() {
+        // Repository 초기화
+        userRepository = new JCFUserRepository();
+        userStatusRepository = new JCFUserStatusRepository();
+        binaryContentRepository = new JCFBinaryContentRepository();
+        channelRepository = new JCFChannelRepository();
+        messageRepository = new JCFMessageRepository();
+        readStatusRepository = new JCFReadStatusRepository();
+
+        // Service 초기화
+        userService = new BasicUserService(userRepository, binaryContentRepository, userStatusRepository);
+        authService = new BasicAuthService(userRepository, userStatusRepository);
+        userStatusService = new BasicUserStatusService(userStatusRepository, userRepository);
+        channelService = new BasicChannelService(channelRepository, readStatusRepository, messageRepository, binaryContentRepository);
+        messageService = new BasicMessageService(messageRepository, binaryContentRepository);
+        readStatusService = new BasicReadStatusService(readStatusRepository, userRepository, channelRepository);
+        binaryContentService = new BasicBinaryContentService(binaryContentRepository);
+
+        outputBuffer = new StringBuilder();
+    }
+
+    public static void main(String[] args) {
+        FunctionalTest test = new FunctionalTest();
+        test.runAllTests();
+    }
+
+    private void runAllTests() {
+        printHeader("DISCODEIT 기능 테스트");
+        printLine("테스트 시작 시간: " + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
+        printSeparator();
+
+        // 사용자 관리 테스트
+        printSection("1. 사용자 관리");
+        testUserCreate();
+        testUserUpdate();
+        testUserDelete();
+        testUserFindAll();
+        testUserStatusUpdate();
+
+        // 권한 관리 테스트
+        printSection("2. 권한 관리");
+        testLogin();
+        testLoginFail();
+
+        // 채널 관리 테스트
+        printSection("3. 채널 관리");
+        testPublicChannelCreate();
+        testPrivateChannelCreate();
+        testPublicChannelUpdate();
+        testPrivateChannelUpdateFail();
+        testChannelDelete();
+        testFindChannelsByUserId();
+
+        // 메시지 관리 테스트
+        printSection("4. 메시지 관리");
+        testMessageCreate();
+        testMessageUpdate();
+        testMessageDelete();
+        testFindMessagesByChannelId();
+
+        // 메시지 수신 정보 관리 테스트
+        printSection("5. 메시지 수신 정보 관리");
+        testReadStatusCreate();
+        testReadStatusUpdate();
+        testFindReadStatusByUserId();
+
+        // 바이너리 파일 다운로드 테스트
+        printSection("6. 바이너리 파일 다운로드");
+        testBinaryContentFindOne();
+        testBinaryContentFindMultiple();
+
+        // 결과 요약
+        printSummary();
+
+        // 파일로 저장
+        saveToFile();
+    }
+
+    // ==================== 사용자 관리 테스트 ====================
+
+    private void testUserCreate() {
+        String testName = "사용자를 등록할 수 있다";
+        try {
+            UserCreateRequest request = new UserCreateRequest("홍길동", "hong@example.com", "password123");
+            UserResponse response = userService.create(request, null);
+
+            printTestResult(testName, true);
+            printDetail("생성된 사용자 ID: " + response.id());
+            printDetail("사용자명: " + response.username());
+            printDetail("이메일: " + response.email());
+            printDetail("온라인 상태: " + response.isOnline());
+            printDetail("생성일시: " + response.createdAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testUserUpdate() {
+        String testName = "사용자 정보를 수정할 수 있다";
+        try {
+            // 먼저 사용자 생성
+            UserCreateRequest createRequest = new UserCreateRequest("김철수", "kim@example.com", "pass123");
+            UserResponse createdUser = userService.create(createRequest, null);
+
+            // 사용자 정보 수정
+            UserUpdateRequest updateRequest = new UserUpdateRequest("김영희", "younghee@example.com", "newpass456");
+            UserResponse updatedUser = userService.update(createdUser.id(), updateRequest, null);
+
+            printTestResult(testName, true);
+            printDetail("수정 전 사용자명: 김철수 → 수정 후: " + updatedUser.username());
+            printDetail("수정 전 이메일: kim@example.com → 수정 후: " + updatedUser.email());
+            printDetail("수정일시: " + updatedUser.updatedAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testUserDelete() {
+        String testName = "사용자를 삭제할 수 있다";
+        try {
+            // 삭제할 사용자 생성
+            UserCreateRequest request = new UserCreateRequest("삭제될사용자", "delete@example.com", "pass");
+            UserResponse createdUser = userService.create(request, null);
+            UUID userId = createdUser.id();
+
+            // 삭제 전 사용자 수
+            int beforeCount = userService.findAll().size();
+
+            // 사용자 삭제
+            userService.delete(userId);
+
+            // 삭제 후 사용자 수
+            int afterCount = userService.findAll().size();
+
+            printTestResult(testName, true);
+            printDetail("삭제된 사용자 ID: " + userId);
+            printDetail("삭제 전 사용자 수: " + beforeCount + " → 삭제 후: " + afterCount);
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testUserFindAll() {
+        String testName = "모든 사용자를 조회할 수 있다";
+        try {
+            // 추가 사용자 생성
+            userService.create(new UserCreateRequest("사용자A", "userA@example.com", "pass"), null);
+            userService.create(new UserCreateRequest("사용자B", "userB@example.com", "pass"), null);
+
+            List<UserResponse> allUsers = userService.findAll();
+
+            printTestResult(testName, true);
+            printDetail("전체 사용자 수: " + allUsers.size());
+            for (UserResponse user : allUsers) {
+                printDetail("  - " + user.username() + " (" + user.email() + ") - 온라인: " + user.isOnline());
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testUserStatusUpdate() {
+        String testName = "사용자의 온라인 상태를 업데이트할 수 있다";
+        try {
+            // 사용자 생성
+            UserCreateRequest request = new UserCreateRequest("상태테스트", "status@example.com", "pass");
+            UserResponse user = userService.create(request, null);
+
+            // UserStatus 조회
+            UserStatus userStatus = userStatusService.findByUserId(user.id());
+            Instant beforeTime = userStatus.getLastActiveAt();
+
+            // 상태 업데이트
+            Thread.sleep(100); // 시간 차이를 위해
+            Instant newTime = Instant.now();
+            UserStatus updatedStatus = userStatusService.update(userStatus.getId(), new UserStatusUpdateRequest(newTime));
+
+            printTestResult(testName, true);
+            printDetail("사용자 ID: " + user.id());
+            printDetail("업데이트 전 마지막 활동: " + beforeTime);
+            printDetail("업데이트 후 마지막 활동: " + updatedStatus.getLastActiveAt());
+            printDetail("온라인 상태: " + updatedStatus.isOnline());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 권한 관리 테스트 ====================
+
+    private void testLogin() {
+        String testName = "사용자는 로그인할 수 있다";
+        try {
+            // 로그인할 사용자 생성
+            UserCreateRequest createRequest = new UserCreateRequest("로그인사용자", "login@example.com", "mypassword");
+            userService.create(createRequest, null);
+
+            // 로그인 시도
+            LoginRequest loginRequest = new LoginRequest("로그인사용자", "mypassword");
+            UserResponse loggedInUser = authService.login(loginRequest);
+
+            printTestResult(testName, true);
+            printDetail("로그인 사용자: " + loggedInUser.username());
+            printDetail("이메일: " + loggedInUser.email());
+            printDetail("사용자 ID: " + loggedInUser.id());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testLoginFail() {
+        String testName = "잘못된 비밀번호로 로그인 시 실패한다";
+        try {
+            // 사용자 생성
+            UserCreateRequest createRequest = new UserCreateRequest("실패테스트", "fail@example.com", "correctpass");
+            userService.create(createRequest, null);
+
+            // 잘못된 비밀번호로 로그인 시도
+            LoginRequest loginRequest = new LoginRequest("실패테스트", "wrongpassword");
+            try {
+                authService.login(loginRequest);
+                printTestResult(testName, false);
+                printDetail("예외가 발생해야 하는데 발생하지 않음");
+            } catch (Exception e) {
+                printTestResult(testName, true);
+                printDetail("예상대로 로그인 실패: " + e.getMessage());
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 채널 관리 테스트 ====================
+
+    private void testPublicChannelCreate() {
+        String testName = "공개 채널을 생성할 수 있다";
+        try {
+            PublicChannelCreateRequest request = new PublicChannelCreateRequest("일반", "일반 대화 채널입니다");
+            ChannelResponse response = channelService.createPublic(request);
+
+            printTestResult(testName, true);
+            printDetail("채널 ID: " + response.id());
+            printDetail("채널 타입: " + response.type());
+            printDetail("채널명: " + response.name());
+            printDetail("설명: " + response.description());
+            printDetail("생성일시: " + response.createdAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testPrivateChannelCreate() {
+        String testName = "비공개 채널을 생성할 수 있다";
+        try {
+            // 참여자 생성
+            UserResponse user1 = userService.create(new UserCreateRequest("비공개1", "private1@example.com", "pass"), null);
+            UserResponse user2 = userService.create(new UserCreateRequest("비공개2", "private2@example.com", "pass"), null);
+
+            PrivateChannelCreateRequest request = new PrivateChannelCreateRequest(List.of(user1.id(), user2.id()));
+            ChannelResponse response = channelService.createPrivate(request);
+
+            printTestResult(testName, true);
+            printDetail("채널 ID: " + response.id());
+            printDetail("채널 타입: " + response.type());
+            printDetail("참여자 수: " + response.participantIds().size());
+            printDetail("참여자 ID 목록: " + response.participantIds());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testPublicChannelUpdate() {
+        String testName = "공개 채널의 정보를 수정할 수 있다";
+        try {
+            // 채널 생성
+            PublicChannelCreateRequest createRequest = new PublicChannelCreateRequest("수정전채널", "수정 전 설명");
+            ChannelResponse createdChannel = channelService.createPublic(createRequest);
+
+            // 채널 수정
+            ChannelUpdateRequest updateRequest = new ChannelUpdateRequest("수정후채널", "수정 후 설명입니다");
+            ChannelResponse updatedChannel = channelService.update(createdChannel.id(), updateRequest);
+
+            printTestResult(testName, true);
+            printDetail("수정 전 채널명: 수정전채널 → 수정 후: " + updatedChannel.name());
+            printDetail("수정 전 설명: 수정 전 설명 → 수정 후: " + updatedChannel.description());
+            printDetail("수정일시: " + updatedChannel.updatedAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testPrivateChannelUpdateFail() {
+        String testName = "비공개 채널은 수정할 수 없다";
+        try {
+            // 비공개 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("수정불가", "noupdate@example.com", "pass"), null);
+            PrivateChannelCreateRequest createRequest = new PrivateChannelCreateRequest(List.of(user.id()));
+            ChannelResponse privateChannel = channelService.createPrivate(createRequest);
+
+            // 수정 시도
+            ChannelUpdateRequest updateRequest = new ChannelUpdateRequest("수정시도", "수정 시도 설명");
+            try {
+                channelService.update(privateChannel.id(), updateRequest);
+                printTestResult(testName, false);
+                printDetail("예외가 발생해야 하는데 발생하지 않음");
+            } catch (IllegalArgumentException e) {
+                printTestResult(testName, true);
+                printDetail("예상대로 수정 실패: " + e.getMessage());
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testChannelDelete() {
+        String testName = "채널을 삭제할 수 있다";
+        try {
+            // 채널 생성
+            PublicChannelCreateRequest request = new PublicChannelCreateRequest("삭제될채널", "곧 삭제됩니다");
+            ChannelResponse createdChannel = channelService.createPublic(request);
+            UUID channelId = createdChannel.id();
+
+            // 채널 삭제
+            channelService.delete(channelId);
+
+            printTestResult(testName, true);
+            printDetail("삭제된 채널 ID: " + channelId);
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testFindChannelsByUserId() {
+        String testName = "특정 사용자가 볼 수 있는 모든 채널 목록을 조회할 수 있다";
+        try {
+            // 사용자 생성
+            UserResponse user1 = userService.create(new UserCreateRequest("채널조회1", "channel1@example.com", "pass"), null);
+            UserResponse user2 = userService.create(new UserCreateRequest("채널조회2", "channel2@example.com", "pass"), null);
+
+            // 공개 채널 생성
+            channelService.createPublic(new PublicChannelCreateRequest("공개채널A", "공개A"));
+            channelService.createPublic(new PublicChannelCreateRequest("공개채널B", "공개B"));
+
+            // 비공개 채널 생성 (user1만 참여)
+            channelService.createPrivate(new PrivateChannelCreateRequest(List.of(user1.id())));
+
+            // 각 사용자별 채널 조회
+            List<ChannelResponse> user1Channels = channelService.findAllByUserId(user1.id());
+            List<ChannelResponse> user2Channels = channelService.findAllByUserId(user2.id());
+
+            printTestResult(testName, true);
+            printDetail("사용자1 (비공개 채널 참여) 조회 가능 채널 수: " + user1Channels.size());
+            for (ChannelResponse ch : user1Channels) {
+                printDetail("  - [" + ch.type() + "] " + (ch.name() != null ? ch.name() : "비공개채널"));
+            }
+            printDetail("사용자2 (비공개 채널 미참여) 조회 가능 채널 수: " + user2Channels.size());
+            for (ChannelResponse ch : user2Channels) {
+                printDetail("  - [" + ch.type() + "] " + (ch.name() != null ? ch.name() : "비공개채널"));
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 메시지 관리 테스트 ====================
+
+    private void testMessageCreate() {
+        String testName = "메시지를 보낼 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("메시지작성자", "msg@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("메시지채널", "메시지 테스트"));
+
+            // 메시지 생성
+            MessageCreateRequest request = new MessageCreateRequest("안녕하세요! 첫 번째 메시지입니다.", channel.id(), user.id());
+            MessageResponse response = messageService.create(request, null);
+
+            printTestResult(testName, true);
+            printDetail("메시지 ID: " + response.id());
+            printDetail("내용: " + response.content());
+            printDetail("작성자 ID: " + response.authorId());
+            printDetail("채널 ID: " + response.channelId());
+            printDetail("작성일시: " + response.createdAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testMessageUpdate() {
+        String testName = "메시지를 수정할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("메시지수정자", "msgupdate@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("수정테스트채널", "수정 테스트"));
+
+            // 메시지 생성
+            MessageCreateRequest createRequest = new MessageCreateRequest("원래 메시지 내용", channel.id(), user.id());
+            MessageResponse createdMessage = messageService.create(createRequest, null);
+
+            // 메시지 수정
+            MessageUpdateRequest updateRequest = new MessageUpdateRequest("수정된 메시지 내용입니다!");
+            MessageResponse updatedMessage = messageService.update(createdMessage.id(), updateRequest);
+
+            printTestResult(testName, true);
+            printDetail("수정 전: 원래 메시지 내용");
+            printDetail("수정 후: " + updatedMessage.content());
+            printDetail("수정일시: " + updatedMessage.updatedAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testMessageDelete() {
+        String testName = "메시지를 삭제할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("메시지삭제자", "msgdelete@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("삭제테스트채널", "삭제 테스트"));
+
+            // 메시지 생성
+            MessageCreateRequest request = new MessageCreateRequest("삭제될 메시지", channel.id(), user.id());
+            MessageResponse createdMessage = messageService.create(request, null);
+            UUID messageId = createdMessage.id();
+
+            // 삭제 전 메시지 수
+            int beforeCount = messageService.findAllByChannelId(channel.id()).size();
+
+            // 메시지 삭제
+            messageService.delete(messageId);
+
+            // 삭제 후 메시지 수
+            int afterCount = messageService.findAllByChannelId(channel.id()).size();
+
+            printTestResult(testName, true);
+            printDetail("삭제된 메시지 ID: " + messageId);
+            printDetail("삭제 전 메시지 수: " + beforeCount + " → 삭제 후: " + afterCount);
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testFindMessagesByChannelId() {
+        String testName = "특정 채널의 메시지 목록을 조회할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("메시지목록", "msglist@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("목록테스트채널", "목록 테스트"));
+
+            // 여러 메시지 생성
+            messageService.create(new MessageCreateRequest("첫 번째 메시지", channel.id(), user.id()), null);
+            messageService.create(new MessageCreateRequest("두 번째 메시지", channel.id(), user.id()), null);
+            messageService.create(new MessageCreateRequest("세 번째 메시지", channel.id(), user.id()), null);
+
+            // 메시지 목록 조회
+            List<MessageResponse> messages = messageService.findAllByChannelId(channel.id());
+
+            printTestResult(testName, true);
+            printDetail("채널 ID: " + channel.id());
+            printDetail("메시지 수: " + messages.size());
+            for (MessageResponse msg : messages) {
+                printDetail("  - " + msg.content() + " (작성: " + msg.createdAt() + ")");
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 메시지 수신 정보 관리 테스트 ====================
+
+    private void testReadStatusCreate() {
+        String testName = "특정 채널의 메시지 수신 정보를 생성할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("수신정보생성", "readcreate@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("수신정보채널", "수신 정보 테스트"));
+
+            // 수신 정보 생성
+            Instant now = Instant.now();
+            ReadStatusCreateRequest request = new ReadStatusCreateRequest(user.id(), channel.id(), now);
+            ReadStatus readStatus = readStatusService.create(request);
+
+            printTestResult(testName, true);
+            printDetail("수신 정보 ID: " + readStatus.getId());
+            printDetail("사용자 ID: " + readStatus.getUserId());
+            printDetail("채널 ID: " + readStatus.getChannelId());
+            printDetail("마지막 읽은 시간: " + readStatus.getLastReadAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testReadStatusUpdate() {
+        String testName = "특정 채널의 메시지 수신 정보를 수정할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("수신정보수정", "readupdate@example.com", "pass"), null);
+            ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("수신수정채널", "수신 수정 테스트"));
+
+            // 수신 정보 생성
+            Instant oldTime = Instant.now().minusSeconds(3600);
+            ReadStatusCreateRequest createRequest = new ReadStatusCreateRequest(user.id(), channel.id(), oldTime);
+            ReadStatus createdReadStatus = readStatusService.create(createRequest);
+
+            // 수신 정보 수정
+            Instant newTime = Instant.now();
+            ReadStatusUpdateRequest updateRequest = new ReadStatusUpdateRequest(newTime);
+            ReadStatus updatedReadStatus = readStatusService.update(createdReadStatus.getId(), updateRequest);
+
+            printTestResult(testName, true);
+            printDetail("수정 전 마지막 읽은 시간: " + oldTime);
+            printDetail("수정 후 마지막 읽은 시간: " + updatedReadStatus.getLastReadAt());
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testFindReadStatusByUserId() {
+        String testName = "특정 사용자의 메시지 수신 정보를 조회할 수 있다";
+        try {
+            // 사용자와 채널 생성
+            UserResponse user = userService.create(new UserCreateRequest("수신정보조회", "readfind@example.com", "pass"), null);
+            ChannelResponse channel1 = channelService.createPublic(new PublicChannelCreateRequest("수신조회채널1", "채널1"));
+            ChannelResponse channel2 = channelService.createPublic(new PublicChannelCreateRequest("수신조회채널2", "채널2"));
+
+            // 수신 정보 생성
+            readStatusService.create(new ReadStatusCreateRequest(user.id(), channel1.id(), Instant.now()));
+            readStatusService.create(new ReadStatusCreateRequest(user.id(), channel2.id(), Instant.now()));
+
+            // 수신 정보 조회
+            List<ReadStatus> readStatuses = readStatusService.findAllByUserId(user.id());
+
+            printTestResult(testName, true);
+            printDetail("사용자 ID: " + user.id());
+            printDetail("수신 정보 수: " + readStatuses.size());
+            for (ReadStatus rs : readStatuses) {
+                printDetail("  - 채널 ID: " + rs.getChannelId() + ", 마지막 읽은 시간: " + rs.getLastReadAt());
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 바이너리 파일 다운로드 테스트 ====================
+
+    private void testBinaryContentFindOne() {
+        String testName = "바이너리 파일을 1개 조회할 수 있다";
+        try {
+            // 바이너리 콘텐츠 생성
+            byte[] data = "테스트 파일 내용입니다.".getBytes();
+            BinaryContentCreateRequest request = new BinaryContentCreateRequest("test.txt", "text/plain", data);
+            BinaryContent createdContent = binaryContentService.create(request);
+
+            // 바이너리 콘텐츠 조회
+            BinaryContent foundContent = binaryContentService.find(createdContent.getId());
+
+            printTestResult(testName, true);
+            printDetail("파일 ID: " + foundContent.getId());
+            printDetail("파일명: " + foundContent.getFileName());
+            printDetail("Content-Type: " + foundContent.getContentType());
+            printDetail("데이터 크기: " + foundContent.getData().length + " bytes");
+            printDetail("데이터 내용: " + new String(foundContent.getData()));
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    private void testBinaryContentFindMultiple() {
+        String testName = "바이너리 파일을 여러 개 조회할 수 있다";
+        try {
+            // 여러 바이너리 콘텐츠 생성
+            BinaryContent content1 = binaryContentService.create(
+                    new BinaryContentCreateRequest("file1.txt", "text/plain", "내용1".getBytes()));
+            BinaryContent content2 = binaryContentService.create(
+                    new BinaryContentCreateRequest("file2.png", "image/png", new byte[]{1, 2, 3, 4, 5}));
+            BinaryContent content3 = binaryContentService.create(
+                    new BinaryContentCreateRequest("file3.pdf", "application/pdf", new byte[]{10, 20, 30}));
+
+            // 여러 개 조회
+            List<UUID> ids = List.of(content1.getId(), content2.getId(), content3.getId());
+            List<BinaryContent> contents = binaryContentService.findAllByIdIn(ids);
+
+            printTestResult(testName, true);
+            printDetail("요청한 파일 수: " + ids.size());
+            printDetail("조회된 파일 수: " + contents.size());
+            for (BinaryContent content : contents) {
+                printDetail("  - " + content.getFileName() + " (" + content.getContentType() + ", " + content.getData().length + " bytes)");
+            }
+        } catch (Exception e) {
+            printTestResult(testName, false);
+            printDetail("오류: " + e.getMessage());
+        }
+    }
+
+    // ==================== 출력 헬퍼 메서드 ====================
+
+    private void print(String message) {
+        System.out.println(message);
+        outputBuffer.append(message).append("\n");
+    }
+
+    private void printHeader(String title) {
+        String header = "\n" + "=".repeat(60) + "\n" + "  " + title + "\n" + "=".repeat(60);
+        print(header);
+    }
+
+    private void printSection(String section) {
+        print("\n" + "-".repeat(50));
+        print("[ " + section + " ]");
+        print("-".repeat(50));
+    }
+
+    private void printSeparator() {
+        print("-".repeat(60));
+    }
+
+    private void printLine(String line) {
+        print(line);
+    }
+
+    private void printTestResult(String testName, boolean passed) {
+        testCount++;
+        if (passed) {
+            passCount++;
+            print("\n[PASS] " + testName);
+        } else {
+            failCount++;
+            print("\n[FAIL] " + testName);
+        }
+    }
+
+    private void printDetail(String detail) {
+        print("       " + detail);
+    }
+
+    private void printSummary() {
+        print("\n" + "=".repeat(60));
+        print("  테스트 결과 요약");
+        print("=".repeat(60));
+        print("전체 테스트: " + testCount);
+        print("성공: " + passCount);
+        print("실패: " + failCount);
+        print("성공률: " + String.format("%.1f", (passCount * 100.0 / testCount)) + "%");
+        print("=".repeat(60));
+        print("테스트 종료 시간: " + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
+    }
+
+    private void saveToFile() {
+        String fileName = "test_result_" + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss")) + ".txt";
+        String filePath = "build/" + fileName;
+
+        try (PrintWriter writer = new PrintWriter(new FileWriter(filePath))) {
+            writer.print(outputBuffer.toString());
+            print("\n결과가 파일로 저장되었습니다: " + filePath);
+        } catch (IOException e) {
+            print("\n파일 저장 실패: " + e.getMessage());
+        }
+    }
+}
diff --git a/discodeit/src/test/java/com/sprint/mission/discodeit/service/IntegrationServiceTest.java b/discodeit/src/test/java/com/sprint/mission/discodeit/service/IntegrationServiceTest.java
new file mode 100644
index 00000000..bc48a76b
--- /dev/null
+++ b/discodeit/src/test/java/com/sprint/mission/discodeit/service/IntegrationServiceTest.java
@@ -0,0 +1,563 @@
+package com.sprint.mission.discodeit.service;
+
+import com.sprint.mission.discodeit.dto.request.*;
+import com.sprint.mission.discodeit.dto.response.ChannelResponse;
+import com.sprint.mission.discodeit.dto.response.MessageResponse;
+import com.sprint.mission.discodeit.dto.response.UserResponse;
+import com.sprint.mission.discodeit.entity.BinaryContent;
+import com.sprint.mission.discodeit.entity.ChannelType;
+import com.sprint.mission.discodeit.entity.ReadStatus;
+import com.sprint.mission.discodeit.entity.UserStatus;
+import com.sprint.mission.discodeit.repository.jcf.*;
+import com.sprint.mission.discodeit.service.basic.*;
+import org.junit.jupiter.api.*;
+
+import java.time.Instant;
+import java.util.List;
+import java.util.UUID;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * 요구사항 기반 통합 테스트
+ *
+ * 사용자 관리, 권한 관리, 채널 관리, 메시지 관리,
+ * 메시지 수신 정보 관리, 바이너리 파일 다운로드 기능을 검증합니다.
+ */
+@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
+class IntegrationServiceTest {
+
+    // Repositories
+    private JCFUserRepository userRepository;
+    private JCFUserStatusRepository userStatusRepository;
+    private JCFBinaryContentRepository binaryContentRepository;
+    private JCFChannelRepository channelRepository;
+    private JCFMessageRepository messageRepository;
+    private JCFReadStatusRepository readStatusRepository;
+
+    // Services
+    private UserService userService;
+    private AuthService authService;
+    private UserStatusService userStatusService;
+    private ChannelService channelService;
+    private MessageService messageService;
+    private ReadStatusService readStatusService;
+    private BinaryContentService binaryContentService;
+
+    @BeforeEach
+    void setUp() {
+        // JCF Repository 초기화
+        userRepository = new JCFUserRepository();
+        userStatusRepository = new JCFUserStatusRepository();
+        binaryContentRepository = new JCFBinaryContentRepository();
+        channelRepository = new JCFChannelRepository();
+        messageRepository = new JCFMessageRepository();
+        readStatusRepository = new JCFReadStatusRepository();
+
+        // Service 초기화
+        userService = new BasicUserService(userRepository, binaryContentRepository, userStatusRepository);
+        authService = new BasicAuthService(userRepository, userStatusRepository);
+        userStatusService = new BasicUserStatusService(userStatusRepository, userRepository);
+        channelService = new BasicChannelService(channelRepository, readStatusRepository, messageRepository, binaryContentRepository);
+        messageService = new BasicMessageService(messageRepository, binaryContentRepository);
+        readStatusService = new BasicReadStatusService(readStatusRepository, userRepository, channelRepository);
+        binaryContentService = new BasicBinaryContentService(binaryContentRepository);
+    }
+
+    // ==================== 사용자 관리 테스트 ====================
+
+    @Test
+    @Order(1)
+    @DisplayName("사용자를 등록할 수 있다")
+    void createUser() {
+        // given
+        UserCreateRequest request = new UserCreateRequest("testuser", "test@example.com", "password123");
+
+        // when
+        UserResponse response = userService.create(request, null);
+
+        // then
+        assertNotNull(response);
+        assertNotNull(response.id());
+        assertEquals("testuser", response.username());
+        assertEquals("test@example.com", response.email());
+        assertTrue(response.isOnline());
+    }
+
+    @Test
+    @Order(2)
+    @DisplayName("사용자 정보를 수정할 수 있다")
+    void updateUser() {
+        // given
+        UserCreateRequest createRequest = new UserCreateRequest("olduser", "old@example.com", "oldpass");
+        UserResponse createdUser = userService.create(createRequest, null);
+
+        UserUpdateRequest updateRequest = new UserUpdateRequest("newuser", "new@example.com", "newpass");
+
+        // when
+        UserResponse updatedUser = userService.update(createdUser.id(), updateRequest, null);
+
+        // then
+        assertEquals(createdUser.id(), updatedUser.id());
+        assertEquals("newuser", updatedUser.username());
+        assertEquals("new@example.com", updatedUser.email());
+    }
+
+    @Test
+    @Order(3)
+    @DisplayName("사용자를 삭제할 수 있다")
+    void deleteUser() {
+        // given
+        UserCreateRequest request = new UserCreateRequest("deleteuser", "delete@example.com", "password");
+        UserResponse createdUser = userService.create(request, null);
+
+        // when
+        userService.delete(createdUser.id());
+
+        // then
+        List<UserResponse> allUsers = userService.findAll();
+        assertTrue(allUsers.stream().noneMatch(u -> u.id().equals(createdUser.id())));
+    }
+
+    @Test
+    @Order(4)
+    @DisplayName("모든 사용자를 조회할 수 있다")
+    void findAllUsers() {
+        // given
+        userService.create(new UserCreateRequest("user1", "user1@example.com", "pass1"), null);
+        userService.create(new UserCreateRequest("user2", "user2@example.com", "pass2"), null);
+        userService.create(new UserCreateRequest("user3", "user3@example.com", "pass3"), null);
+
+        // when
+        List<UserResponse> allUsers = userService.findAll();
+
+        // then
+        assertEquals(3, allUsers.size());
+    }
+
+    @Test
+    @Order(5)
+    @DisplayName("사용자의 온라인 상태를 업데이트할 수 있다")
+    void updateUserOnlineStatus() {
+        // given
+        UserCreateRequest createRequest = new UserCreateRequest("statususer", "status@example.com", "password");
+        UserResponse createdUser = userService.create(createRequest, null);
+
+        UserStatus userStatus = userStatusService.findByUserId(createdUser.id());
+        Instant newAccessTime = Instant.now();
+
+        // when
+        UserStatus updatedStatus = userStatusService.update(userStatus.getId(), new UserStatusUpdateRequest(newAccessTime));
+
+        // then
+        assertNotNull(updatedStatus);
+        assertEquals(newAccessTime, updatedStatus.getLastActiveAt());
+    }
+
+    // ==================== 권한 관리 테스트 ====================
+
+    @Test
+    @Order(6)
+    @DisplayName("사용자는 로그인할 수 있다")
+    void loginUser() {
+        // given
+        UserCreateRequest createRequest = new UserCreateRequest("loginuser", "login@example.com", "mypassword");
+        userService.create(createRequest, null);
+
+        LoginRequest loginRequest = new LoginRequest("loginuser", "mypassword");
+
+        // when
+        UserResponse loggedInUser = authService.login(loginRequest);
+
+        // then
+        assertNotNull(loggedInUser);
+        assertEquals("loginuser", loggedInUser.username());
+        assertEquals("login@example.com", loggedInUser.email());
+    }
+
+    @Test
+    @Order(7)
+    @DisplayName("잘못된 비밀번호로 로그인 시 예외가 발생한다")
+    void loginWithWrongPassword() {
+        // given
+        UserCreateRequest createRequest = new UserCreateRequest("wrongpassuser", "wrongpass@example.com", "correctpass");
+        userService.create(createRequest, null);
+
+        LoginRequest loginRequest = new LoginRequest("wrongpassuser", "wrongpassword");
+
+        // when & then
+        assertThrows(Exception.class, () -> authService.login(loginRequest));
+    }
+
+    // ==================== 채널 관리 테스트 ====================
+
+    @Test
+    @Order(8)
+    @DisplayName("공개 채널을 생성할 수 있다")
+    void createPublicChannel() {
+        // given
+        PublicChannelCreateRequest request = new PublicChannelCreateRequest("general", "일반 채널입니다");
+
+        // when
+        ChannelResponse response = channelService.createPublic(request);
+
+        // then
+        assertNotNull(response);
+        assertNotNull(response.id());
+        assertEquals(ChannelType.PUBLIC, response.type());
+        assertEquals("general", response.name());
+        assertEquals("일반 채널입니다", response.description());
+    }
+
+    @Test
+    @Order(9)
+    @DisplayName("비공개 채널을 생성할 수 있다")
+    void createPrivateChannel() {
+        // given
+        UserResponse user1 = userService.create(new UserCreateRequest("privateuser1", "private1@example.com", "pass"), null);
+        UserResponse user2 = userService.create(new UserCreateRequest("privateuser2", "private2@example.com", "pass"), null);
+
+        PrivateChannelCreateRequest request = new PrivateChannelCreateRequest(List.of(user1.id(), user2.id()));
+
+        // when
+        ChannelResponse response = channelService.createPrivate(request);
+
+        // then
+        assertNotNull(response);
+        assertEquals(ChannelType.PRIVATE, response.type());
+        assertNull(response.name());
+        assertNull(response.description());
+        assertEquals(2, response.participantIds().size());
+        assertTrue(response.participantIds().contains(user1.id()));
+        assertTrue(response.participantIds().contains(user2.id()));
+    }
+
+    @Test
+    @Order(10)
+    @DisplayName("공개 채널의 정보를 수정할 수 있다")
+    void updatePublicChannel() {
+        // given
+        PublicChannelCreateRequest createRequest = new PublicChannelCreateRequest("oldchannel", "old description");
+        ChannelResponse createdChannel = channelService.createPublic(createRequest);
+
+        ChannelUpdateRequest updateRequest = new ChannelUpdateRequest("newchannel", "new description");
+
+        // when
+        ChannelResponse updatedChannel = channelService.update(createdChannel.id(), updateRequest);
+
+        // then
+        assertEquals(createdChannel.id(), updatedChannel.id());
+        assertEquals("newchannel", updatedChannel.name());
+        assertEquals("new description", updatedChannel.description());
+    }
+
+    @Test
+    @Order(11)
+    @DisplayName("비공개 채널은 수정할 수 없다")
+    void cannotUpdatePrivateChannel() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("notupdateuser", "notupdate@example.com", "pass"), null);
+        PrivateChannelCreateRequest createRequest = new PrivateChannelCreateRequest(List.of(user.id()));
+        ChannelResponse privateChannel = channelService.createPrivate(createRequest);
+
+        ChannelUpdateRequest updateRequest = new ChannelUpdateRequest("tryupdate", "try description");
+
+        // when & then
+        assertThrows(IllegalArgumentException.class, () -> channelService.update(privateChannel.id(), updateRequest));
+    }
+
+    @Test
+    @Order(12)
+    @DisplayName("채널을 삭제할 수 있다")
+    void deleteChannel() {
+        // given
+        PublicChannelCreateRequest createRequest = new PublicChannelCreateRequest("deletechannel", "to be deleted");
+        ChannelResponse createdChannel = channelService.createPublic(createRequest);
+
+        // when
+        channelService.delete(createdChannel.id());
+
+        // then
+        UserResponse user = userService.create(new UserCreateRequest("deletechanneluser", "deletechannel@example.com", "pass"), null);
+        List<ChannelResponse> channels = channelService.findAllByUserId(user.id());
+        assertTrue(channels.stream().noneMatch(c -> c.id().equals(createdChannel.id())));
+    }
+
+    @Test
+    @Order(13)
+    @DisplayName("특정 사용자가 볼 수 있는 모든 채널 목록을 조회할 수 있다")
+    void findAllChannelsByUserId() {
+        // given
+        UserResponse user1 = userService.create(new UserCreateRequest("channeluser1", "channeluser1@example.com", "pass"), null);
+        UserResponse user2 = userService.create(new UserCreateRequest("channeluser2", "channeluser2@example.com", "pass"), null);
+
+        // 공개 채널 생성
+        channelService.createPublic(new PublicChannelCreateRequest("public1", "공개채널1"));
+        channelService.createPublic(new PublicChannelCreateRequest("public2", "공개채널2"));
+
+        // 비공개 채널 생성 (user1만 참여)
+        channelService.createPrivate(new PrivateChannelCreateRequest(List.of(user1.id())));
+
+        // when
+        List<ChannelResponse> user1Channels = channelService.findAllByUserId(user1.id());
+        List<ChannelResponse> user2Channels = channelService.findAllByUserId(user2.id());
+
+        // then
+        assertEquals(3, user1Channels.size()); // 공개 2개 + 비공개 1개
+        assertEquals(2, user2Channels.size()); // 공개 2개만
+    }
+
+    // ==================== 메시지 관리 테스트 ====================
+
+    @Test
+    @Order(14)
+    @DisplayName("메시지를 보낼 수 있다")
+    void createMessage() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("msguser", "msguser@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("msgchannel", "메시지 채널"));
+
+        MessageCreateRequest request = new MessageCreateRequest("안녕하세요!", channel.id(), user.id());
+
+        // when
+        MessageResponse response = messageService.create(request, null);
+
+        // then
+        assertNotNull(response);
+        assertNotNull(response.id());
+        assertEquals("안녕하세요!", response.content());
+        assertEquals(channel.id(), response.channelId());
+        assertEquals(user.id(), response.authorId());
+    }
+
+    @Test
+    @Order(15)
+    @DisplayName("메시지를 수정할 수 있다")
+    void updateMessage() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("msgupdateuser", "msgupdate@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("msgupdatechannel", "수정 테스트"));
+
+        MessageCreateRequest createRequest = new MessageCreateRequest("원래 메시지", channel.id(), user.id());
+        MessageResponse createdMessage = messageService.create(createRequest, null);
+
+        MessageUpdateRequest updateRequest = new MessageUpdateRequest("수정된 메시지");
+
+        // when
+        MessageResponse updatedMessage = messageService.update(createdMessage.id(), updateRequest);
+
+        // then
+        assertEquals(createdMessage.id(), updatedMessage.id());
+        assertEquals("수정된 메시지", updatedMessage.content());
+    }
+
+    @Test
+    @Order(16)
+    @DisplayName("메시지를 삭제할 수 있다")
+    void deleteMessage() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("msgdeleteuser", "msgdelete@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("msgdeletechannel", "삭제 테스트"));
+
+        MessageCreateRequest createRequest = new MessageCreateRequest("삭제될 메시지", channel.id(), user.id());
+        MessageResponse createdMessage = messageService.create(createRequest, null);
+
+        // when
+        messageService.delete(createdMessage.id());
+
+        // then
+        List<MessageResponse> messages = messageService.findAllByChannelId(channel.id());
+        assertTrue(messages.stream().noneMatch(m -> m.id().equals(createdMessage.id())));
+    }
+
+    @Test
+    @Order(17)
+    @DisplayName("특정 채널의 메시지 목록을 조회할 수 있다")
+    void findAllMessagesByChannelId() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("msglistuser", "msglist@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("msglistchannel", "메시지 목록"));
+
+        messageService.create(new MessageCreateRequest("메시지1", channel.id(), user.id()), null);
+        messageService.create(new MessageCreateRequest("메시지2", channel.id(), user.id()), null);
+        messageService.create(new MessageCreateRequest("메시지3", channel.id(), user.id()), null);
+
+        // when
+        List<MessageResponse> messages = messageService.findAllByChannelId(channel.id());
+
+        // then
+        assertEquals(3, messages.size());
+    }
+
+    // ==================== 메시지 수신 정보 관리 테스트 ====================
+
+    @Test
+    @Order(18)
+    @DisplayName("특정 채널의 메시지 수신 정보를 생성할 수 있다")
+    void createReadStatus() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("readstatususer", "readstatus@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("readstatuschannel", "수신정보 테스트"));
+
+        ReadStatusCreateRequest request = new ReadStatusCreateRequest(user.id(), channel.id(), Instant.now());
+
+        // when
+        ReadStatus readStatus = readStatusService.create(request);
+
+        // then
+        assertNotNull(readStatus);
+        assertNotNull(readStatus.getId());
+        assertEquals(user.id(), readStatus.getUserId());
+        assertEquals(channel.id(), readStatus.getChannelId());
+    }
+
+    @Test
+    @Order(19)
+    @DisplayName("특정 채널의 메시지 수신 정보를 수정할 수 있다")
+    void updateReadStatus() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("readupdateuser", "readupdate@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("readupdatechannel", "수신정보 수정"));
+
+        ReadStatusCreateRequest createRequest = new ReadStatusCreateRequest(user.id(), channel.id(), Instant.now().minusSeconds(3600));
+        ReadStatus createdReadStatus = readStatusService.create(createRequest);
+
+        Instant newLastReadAt = Instant.now();
+        ReadStatusUpdateRequest updateRequest = new ReadStatusUpdateRequest(newLastReadAt);
+
+        // when
+        ReadStatus updatedReadStatus = readStatusService.update(createdReadStatus.getId(), updateRequest);
+
+        // then
+        assertEquals(createdReadStatus.getId(), updatedReadStatus.getId());
+        assertEquals(newLastReadAt, updatedReadStatus.getLastReadAt());
+    }
+
+    @Test
+    @Order(20)
+    @DisplayName("특정 사용자의 메시지 수신 정보를 조회할 수 있다")
+    void findAllReadStatusByUserId() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("readfinduser", "readfind@example.com", "pass"), null);
+        ChannelResponse channel1 = channelService.createPublic(new PublicChannelCreateRequest("readfindchannel1", "채널1"));
+        ChannelResponse channel2 = channelService.createPublic(new PublicChannelCreateRequest("readfindchannel2", "채널2"));
+
+        readStatusService.create(new ReadStatusCreateRequest(user.id(), channel1.id(), Instant.now()));
+        readStatusService.create(new ReadStatusCreateRequest(user.id(), channel2.id(), Instant.now()));
+
+        // when
+        List<ReadStatus> readStatuses = readStatusService.findAllByUserId(user.id());
+
+        // then
+        assertEquals(2, readStatuses.size());
+        assertTrue(readStatuses.stream().allMatch(rs -> rs.getUserId().equals(user.id())));
+    }
+
+    // ==================== 바이너리 파일 다운로드 테스트 ====================
+
+    @Test
+    @Order(21)
+    @DisplayName("바이너리 파일을 1개 조회할 수 있다")
+    void findOneBinaryContent() {
+        // given
+        BinaryContentCreateRequest request = new BinaryContentCreateRequest(
+                "test.png",
+                "image/png",
+                new byte[]{1, 2, 3, 4, 5}
+        );
+        BinaryContent createdContent = binaryContentService.create(request);
+
+        // when
+        BinaryContent foundContent = binaryContentService.find(createdContent.getId());
+
+        // then
+        assertNotNull(foundContent);
+        assertEquals(createdContent.getId(), foundContent.getId());
+        assertEquals("test.png", foundContent.getFileName());
+        assertEquals("image/png", foundContent.getContentType());
+        assertArrayEquals(new byte[]{1, 2, 3, 4, 5}, foundContent.getData());
+    }
+
+    @Test
+    @Order(22)
+    @DisplayName("바이너리 파일을 여러 개 조회할 수 있다")
+    void findMultipleBinaryContents() {
+        // given
+        BinaryContent content1 = binaryContentService.create(new BinaryContentCreateRequest("file1.txt", "text/plain", "내용1".getBytes()));
+        BinaryContent content2 = binaryContentService.create(new BinaryContentCreateRequest("file2.txt", "text/plain", "내용2".getBytes()));
+        BinaryContent content3 = binaryContentService.create(new BinaryContentCreateRequest("file3.txt", "text/plain", "내용3".getBytes()));
+
+        List<UUID> ids = List.of(content1.getId(), content2.getId(), content3.getId());
+
+        // when
+        List<BinaryContent> contents = binaryContentService.findAllByIdIn(ids);
+
+        // then
+        assertEquals(3, contents.size());
+    }
+
+    // ==================== 추가 통합 테스트 ====================
+
+    @Test
+    @Order(23)
+    @DisplayName("프로필 이미지와 함께 사용자를 등록할 수 있다")
+    void createUserWithProfile() {
+        // given
+        UserCreateRequest userRequest = new UserCreateRequest("profileuser", "profile@example.com", "password");
+        BinaryContentCreateRequest profileRequest = new BinaryContentCreateRequest(
+                "profile.jpg",
+                "image/jpeg",
+                new byte[]{10, 20, 30}
+        );
+
+        // when
+        UserResponse response = userService.create(userRequest, profileRequest);
+
+        // then
+        assertNotNull(response);
+        assertNotNull(response.profileId());
+        assertEquals("profileuser", response.username());
+    }
+
+    @Test
+    @Order(24)
+    @DisplayName("첨부파일과 함께 메시지를 보낼 수 있다")
+    void createMessageWithAttachments() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("attachuser", "attach@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("attachchannel", "첨부파일 테스트"));
+
+        MessageCreateRequest messageRequest = new MessageCreateRequest("첨부파일 있는 메시지", channel.id(), user.id());
+        List<BinaryContentCreateRequest> attachments = List.of(
+                new BinaryContentCreateRequest("attach1.pdf", "application/pdf", new byte[]{1, 2, 3}),
+                new BinaryContentCreateRequest("attach2.png", "image/png", new byte[]{4, 5, 6})
+        );
+
+        // when
+        MessageResponse response = messageService.create(messageRequest, attachments);
+
+        // then
+        assertNotNull(response);
+        assertNotNull(response.attachmentIds());
+        assertEquals(2, response.attachmentIds().size());
+    }
+
+    @Test
+    @Order(25)
+    @DisplayName("채널 삭제 시 관련 메시지도 함께 삭제된다")
+    void deleteChannelWithMessages() {
+        // given
+        UserResponse user = userService.create(new UserCreateRequest("cascadeuser", "cascade@example.com", "pass"), null);
+        ChannelResponse channel = channelService.createPublic(new PublicChannelCreateRequest("cascadechannel", "cascade test"));
+
+        messageService.create(new MessageCreateRequest("메시지1", channel.id(), user.id()), null);
+        messageService.create(new MessageCreateRequest("메시지2", channel.id(), user.id()), null);
+
+        // when
+        channelService.delete(channel.id());
+
+        // then
+        List<MessageResponse> messages = messageService.findAllByChannelId(channel.id());
+        assertTrue(messages.isEmpty());
+    }
+}
diff --git a/discodeit/test_api_automation.py b/discodeit/test_api_automation.py
new file mode 100644
index 00000000..02fc2f33
--- /dev/null
+++ b/discodeit/test_api_automation.py
@@ -0,0 +1,477 @@
+#!/usr/bin/env python3
+"""
+디스코드잇 API 자동화 테스트 스크립트
+
+사용법:
+    python test_api_automation.py
+
+요구사항:
+    pip install requests
+"""
+
+import requests
+import json
+from datetime import datetime
+from typing import Dict, Optional
+import sys
+
+
+class DiscodeitAPITester:
+    """디스코드잇 API 테스트 클래스"""
+
+    def __init__(self, base_url: str = "http://localhost:8080"):
+        self.base_url = base_url
+        self.session = requests.Session()
+        self.session.headers.update({"Content-Type": "application/json"})
+
+        # 테스트 데이터 저장
+        self.user_id: Optional[str] = None
+        self.channel_id: Optional[str] = None
+        self.message_id: Optional[str] = None
+        self.read_status_id: Optional[str] = None
+        self.binary_content_id: Optional[str] = None
+
+        # 테스트 결과
+        self.passed = 0
+        self.failed = 0
+        self.errors = []
+
+    def print_header(self, title: str):
+        """헤더 출력"""
+        print("\n" + "=" * 60)
+        print(f"  {title}")
+        print("=" * 60)
+
+    def print_test(self, name: str, passed: bool, detail: str = ""):
+        """테스트 결과 출력"""
+        status = "✓ PASS" if passed else "✗ FAIL"
+        color = "\033[92m" if passed else "\033[91m"
+        reset = "\033[0m"
+
+        print(f"\n{color}[{status}]{reset} {name}")
+        if detail:
+            print(f"       {detail}")
+
+        if passed:
+            self.passed += 1
+        else:
+            self.failed += 1
+            self.errors.append(name)
+
+    def test_user_create(self):
+        """사용자 등록 테스트"""
+        try:
+            response = self.session.post(
+                f"{self.base_url}/users",
+                json={
+                    "username": "apitest_user",
+                    "email": "apitest@example.com",
+                    "password": "testpass123"
+                }
+            )
+
+            if response.status_code == 201:
+                data = response.json()
+                self.user_id = data["id"]
+                self.print_test(
+                    "사용자 등록",
+                    True,
+                    f"사용자 ID: {self.user_id}"
+                )
+            else:
+                self.print_test(
+                    "사용자 등록",
+                    False,
+                    f"Status: {response.status_code}, {response.text}"
+                )
+        except Exception as e:
+            self.print_test("사용자 등록", False, str(e))
+
+    def test_login(self):
+        """로그인 테스트"""
+        try:
+            response = self.session.post(
+                f"{self.base_url}/auth/login",
+                json={
+                    "username": "apitest_user",
+                    "password": "testpass123"
+                }
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "로그인",
+                    True,
+                    f"로그인 사용자: {data['username']}"
+                )
+            else:
+                self.print_test(
+                    "로그인",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("로그인", False, str(e))
+
+    def test_user_list(self):
+        """전체 사용자 조회 테스트"""
+        try:
+            response = self.session.get(f"{self.base_url}/users")
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "전체 사용자 조회",
+                    True,
+                    f"사용자 수: {len(data)}"
+                )
+            else:
+                self.print_test(
+                    "전체 사용자 조회",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("전체 사용자 조회", False, str(e))
+
+    def test_user_get(self):
+        """특정 사용자 조회 테스트"""
+        if not self.user_id:
+            self.print_test("특정 사용자 조회", False, "사용자 ID 없음")
+            return
+
+        try:
+            response = self.session.get(f"{self.base_url}/users/{self.user_id}")
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "특정 사용자 조회",
+                    True,
+                    f"사용자명: {data['username']}"
+                )
+            else:
+                self.print_test(
+                    "특정 사용자 조회",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("특정 사용자 조회", False, str(e))
+
+    def test_user_update(self):
+        """사용자 정보 수정 테스트"""
+        if not self.user_id:
+            self.print_test("사용자 정보 수정", False, "사용자 ID 없음")
+            return
+
+        try:
+            response = self.session.put(
+                f"{self.base_url}/users/{self.user_id}",
+                json={
+                    "username": "updated_apitest",
+                    "email": "updated_apitest@example.com",
+                    "password": "newpass456"
+                }
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "사용자 정보 수정",
+                    True,
+                    f"수정된 사용자명: {data['username']}"
+                )
+            else:
+                self.print_test(
+                    "사용자 정보 수정",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("사용자 정보 수정", False, str(e))
+
+    def test_channel_create_public(self):
+        """공개 채널 생성 테스트"""
+        try:
+            response = self.session.post(
+                f"{self.base_url}/channels/public",
+                json={
+                    "name": "자동화 테스트 채널",
+                    "description": "Python 자동화 스크립트로 생성된 채널"
+                }
+            )
+
+            if response.status_code == 201:
+                data = response.json()
+                self.channel_id = data["id"]
+                self.print_test(
+                    "공개 채널 생성",
+                    True,
+                    f"채널 ID: {self.channel_id}"
+                )
+            else:
+                self.print_test(
+                    "공개 채널 생성",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("공개 채널 생성", False, str(e))
+
+    def test_channel_list(self):
+        """사용자별 채널 목록 조회 테스트"""
+        if not self.user_id:
+            self.print_test("채널 목록 조회", False, "사용자 ID 없음")
+            return
+
+        try:
+            response = self.session.get(
+                f"{self.base_url}/channels",
+                params={"userId": self.user_id}
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "채널 목록 조회",
+                    True,
+                    f"채널 수: {len(data)}"
+                )
+            else:
+                self.print_test(
+                    "채널 목록 조회",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("채널 목록 조회", False, str(e))
+
+    def test_channel_update(self):
+        """채널 정보 수정 테스트"""
+        if not self.channel_id:
+            self.print_test("채널 정보 수정", False, "채널 ID 없음")
+            return
+
+        try:
+            response = self.session.put(
+                f"{self.base_url}/channels/{self.channel_id}",
+                json={
+                    "name": "수정된 채널명",
+                    "description": "수정된 설명입니다"
+                }
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "채널 정보 수정",
+                    True,
+                    f"수정된 채널명: {data['name']}"
+                )
+            else:
+                self.print_test(
+                    "채널 정보 수정",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("채널 정보 수정", False, str(e))
+
+    def test_message_create(self):
+        """메시지 전송 테스트"""
+        if not self.channel_id or not self.user_id:
+            self.print_test("메시지 전송", False, "채널 ID 또는 사용자 ID 없음")
+            return
+
+        try:
+            response = self.session.post(
+                f"{self.base_url}/messages",
+                json={
+                    "content": "자동화 테스트 메시지입니다",
+                    "channelId": self.channel_id,
+                    "authorId": self.user_id
+                }
+            )
+
+            if response.status_code == 201:
+                data = response.json()
+                self.message_id = data["id"]
+                self.print_test(
+                    "메시지 전송",
+                    True,
+                    f"메시지 ID: {self.message_id}"
+                )
+            else:
+                self.print_test(
+                    "메시지 전송",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("메시지 전송", False, str(e))
+
+    def test_message_list(self):
+        """채널별 메시지 조회 테스트"""
+        if not self.channel_id:
+            self.print_test("메시지 목록 조회", False, "채널 ID 없음")
+            return
+
+        try:
+            response = self.session.get(
+                f"{self.base_url}/messages",
+                params={"channelId": self.channel_id}
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "메시지 목록 조회",
+                    True,
+                    f"메시지 수: {len(data)}"
+                )
+            else:
+                self.print_test(
+                    "메시지 목록 조회",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("메시지 목록 조회", False, str(e))
+
+    def test_message_update(self):
+        """메시지 수정 테스트"""
+        if not self.message_id:
+            self.print_test("메시지 수정", False, "메시지 ID 없음")
+            return
+
+        try:
+            response = self.session.put(
+                f"{self.base_url}/messages/{self.message_id}",
+                json={"content": "수정된 메시지 내용"}
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "메시지 수정",
+                    True,
+                    f"수정된 내용: {data['content']}"
+                )
+            else:
+                self.print_test(
+                    "메시지 수정",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("메시지 수정", False, str(e))
+
+    def test_user_status_update(self):
+        """온라인 상태 업데이트 테스트"""
+        if not self.user_id:
+            self.print_test("온라인 상태 업데이트", False, "사용자 ID 없음")
+            return
+
+        try:
+            response = self.session.put(
+                f"{self.base_url}/users/{self.user_id}/status",
+                json={"lastActiveAt": datetime.utcnow().isoformat() + "Z"}
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                self.print_test(
+                    "온라인 상태 업데이트",
+                    True,
+                    f"온라인: {data.get('online', 'N/A')}"
+                )
+            else:
+                self.print_test(
+                    "온라인 상태 업데이트",
+                    False,
+                    f"Status: {response.status_code}"
+                )
+        except Exception as e:
+            self.print_test("온라인 상태 업데이트", False, str(e))
+
+    def print_summary(self):
+        """테스트 결과 요약 출력"""
+        self.print_header("테스트 결과 요약")
+
+        total = self.passed + self.failed
+        success_rate = (self.passed / total * 100) if total > 0 else 0
+
+        print(f"\n총 테스트: {total}")
+        print(f"성공: \033[92m{self.passed}\033[0m")
+        print(f"실패: \033[91m{self.failed}\033[0m")
+        print(f"성공률: {success_rate:.1f}%")
+
+        if self.errors:
+            print("\n실패한 테스트:")
+            for error in self.errors:
+                print(f"  - {error}")
+
+        print("\n생성된 리소스:")
+        print(f"  - 사용자 ID: {self.user_id}")
+        print(f"  - 채널 ID: {self.channel_id}")
+        print(f"  - 메시지 ID: {self.message_id}")
+
+        print("=" * 60)
+
+        return self.failed == 0
+
+    def run_all_tests(self):
+        """모든 테스트 실행"""
+        self.print_header("디스코드잇 API 자동화 테스트 시작")
+        print(f"Base URL: {self.base_url}")
+        print(f"시작 시간: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+
+        # 1. 사용자 관리
+        self.print_header("1. 사용자 관리")
+        self.test_user_create()
+        self.test_login()
+        self.test_user_list()
+        self.test_user_get()
+        self.test_user_update()
+
+        # 2. 채널 관리
+        self.print_header("2. 채널 관리")
+        self.test_channel_create_public()
+        self.test_channel_list()
+        self.test_channel_update()
+
+        # 3. 메시지 관리
+        self.print_header("3. 메시지 관리")
+        self.test_message_create()
+        self.test_message_list()
+        self.test_message_update()
+
+        # 4. 온라인 상태
+        self.print_header("4. 온라인 상태")
+        self.test_user_status_update()
+
+        # 결과 요약
+        success = self.print_summary()
+
+        return 0 if success else 1
+
+
+def main():
+    """메인 함수"""
+    tester = DiscodeitAPITester()
+
+    try:
+        exit_code = tester.run_all_tests()
+        sys.exit(exit_code)
+    except KeyboardInterrupt:
+        print("\n\n테스트가 중단되었습니다.")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n\n예상치 못한 오류 발생: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()