# 🛠️ Spring Boot Blog API Server

## 🚀 Project Overview
기존 **Jekyll(GitHub Pages)** 로 운영하던 정적 블로그의 한계를 극복하고, 확장 가능한 블로그 시스템을 구축하기 위해 개발한 **Spring Boot 기반의 REST API 서버**입니다.

정적 사이트에서는 구현하기 어려웠던 **동적 포스팅 관리, 관리자 대시보드(Admin), 댓글 시스템** 등의 기능을 직접 구현하여 블로그 운영의 효율성을 높였습니다. **RESTful 원칙**에 입각한 API 설계와 **Spring Security**를 활용한 보안/인증 로직을 적용하여 백엔드 아키텍처 역량을 강화하는 데 중점을 두었습니다.

### 🎯 Key Objectives
* **Migration**: 정적 파일(Jekyll) 의존성을 제거하고 DB 기반의 동적 시스템으로 전환
* **Feature Expansion**: 웹 에디터, 게시글 관리, 방문자 통계 등 관리자(Admin) 기능 추가
* **Architecture**: 프론트엔드와 백엔드를 분리한 REST API 서버 구축

### 🛠️ Tech Stack
* **Java 21, Spring Boot 3.5.9**
* **Spring Security, JWT** (Auth)
* **JPA (Hibernate), QueryDSL** (ORM)
* **PostgreSQL, Redis** (Cache/Session)
* **Markdown Parser** (Content)

---
## 🐳 Infrastructure & Deployment
안정적이고 독립적인 실행 환경을 보장하기 위해 **Docker** 기반의 컨테이너 아키텍처를 구축했습니다.

### 🏗️ Dockerfile Highlights
제공된 Dockerfile은 보안과 이미지 경량화에 초점을 맞춰 설계되었습니다.

- **Multi-stage Build**: 빌드 환경(JDK)과 실행 환경(JRE)을 분리하여 최종 이미지 크기를 최소화했습니다.

- **Alpine Linux**: 경량화된 alpine 베이스 이미지를 사용하여 배포 효율성을 높였습니다.

- **Security (Non-root)**: 컨테이너 탈취 시 호스트 시스템 보호를 위해 루트 권한이 아닌 spring 전용 유저로 애플리케이션을 실행합니다.

<details> <summary>👉 <b>Dockerfile 미리보기</b></summary>

```Dockerfile
# 1. Build Stage
FROM eclipse-temurin:21-jdk-alpine AS build
WORKDIR /app
COPY . .
RUN ./gradlew clean bootJar -x test

# 2. Run Stage
FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
# 보안을 위한 전용 유저 생성 및 권한 부여
RUN addgroup -S spring && adduser -S spring -G spring
COPY --from=build --chown=spring:spring /app/build/libs/*.jar app.jar
USER spring:spring

ENTRYPOINT ["java", "-jar", "-Dspring.profiles.active=prod", "app.jar"]
```
</details>

### 🚀 How to Run (with Docker Compose)
DB(PostgreSQL), Cache(Redis), Object Storage(MinIO)를 포함한 전체 인프라를 한 번에 실행할 수 있습니다.

```Bash
# 1. 프로젝트 빌드 및 컨테이너 실행
$ docker-compose up -d --build

# 2. 로그 확인
$ docker-compose logs -f blog-api
````
---
## 🔌 API Reference

**Base URL**: `http://localhost:8080`  
**Auth**: `Authorization: Bearer {Access_Token}`

### 1. 공통 응답 규격 (Common Response)
모든 API 응답은 아래 표준 포맷을 따릅니다.

```json
{
  "code": "SUCCESS",       // 결과 코드 (SUCCESS 또는 ERROR_CODE)
  "message": "요청 성공",   // 응답 메시지
  "data": { ... }          // 실제 데이터 (없을 경우 null)
}
```

## 관련 문서
- [**ENDPOINT**](https://affine.wypark.me/workspace/f85df0c4-a315-4166-94a8-6558cdafff1d/p13joh_beKNJ6R-I9KrFW)  
- [**API 명세서**](https://affine.wypark.me/workspace/f85df0c4-a315-4166-94a8-6558cdafff1d/7fRNXK9utxG4mcekWivGK)