docs: README에 Alembic 마이그레이션 가이드 추가

- Alembic 소개 및 주요 명령어 정리
- 마이그레이션 생성, 적용, 상태 확인 방법
- 스키마/데이터 마이그레이션 예시 코드
- 무중단 배포와의 통합 설명
- 트러블슈팅 가이드

내용 구성:
1. Alembic이란? - 개념 소개
2. 주요 명령어 - 로컬/Docker 실행 방법
3. 마이그레이션 파일 구조
4. 실제 마이그레이션 예시 (스키마/데이터)
5. 무중단 배포와의 통합
6. 트러블슈팅 (충돌, 실패 처리)

사용자 편의:
- 복사 가능한 명령어 예시
- 실제 프로젝트 파일 참조
- plan.md 상세 학습 내용 연결

이제 사용자가 README만 보고도 Alembic을 실전에서
바로 사용할 수 있습니다.

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

Co-Authored-By: Claude <noreply@anthropic.com>

Author: f-lab-piz

README.md

@@ -223,3 +223,138 @@ localhost:8089 에 접속해서 http://localhost 에 요청 보내기 시작.
 # 터미널 2: 배포 실행
 ./deploy.sh
 ```
+
+## 데이터베이스 마이그레이션 (Alembic)
+
+### Alembic이란?
+
+Alembic은 SQLAlchemy를 위한 데이터베이스 마이그레이션 도구입니다. 데이터베이스 스키마 변경을 버전 관리하고, 여러 환경에서 일관되게 적용할 수 있습니다.
+
+### 주요 명령어
+
+```bash
+# 로컬에서 실행 (개발 시)
+DATABASE_URL="postgresql://user:password@localhost:5433/testdb" python3 -m alembic <command>
+
+# Docker 컨테이너에서 실행 (배포 시)
+docker-compose run --rm app1 alembic <command>
+```
+
+#### 마이그레이션 생성
+
+```bash
+# 스키마 변경 자동 감지하여 마이그레이션 생성
+alembic revision --autogenerate -m "설명"
+
+# 수동 마이그레이션 생성 (데이터 변환 등)
+alembic revision -m "설명"
+```
+
+#### 마이그레이션 적용
+
+```bash
+# 최신 버전으로 업그레이드
+alembic upgrade head
+
+# 특정 리비전으로 업그레이드
+alembic upgrade <revision_id>
+
+# 한 단계 롤백
+alembic downgrade -1
+
+# 특정 리비전으로 다운그레이드
+alembic downgrade <revision_id>
+```
+
+#### 마이그레이션 상태 확인
+
+```bash
+# 현재 적용된 마이그레이션 확인
+alembic current
+
+# 마이그레이션 히스토리 확인
+alembic history
+
+# 적용되지 않은 마이그레이션 확인
+alembic heads
+```
+
+### 마이그레이션 파일 구조
+
+```
+alembic/
+├── env.py                    # Alembic 환경 설정
+├── script.py.mako           # 마이그레이션 템플릿
+└── versions/                # 마이그레이션 파일들
+    ├── 0fee3ec0c79f_initial_migration_create_items_table.py
+    ├── 211d1fe6d912_add_price_and_stock_columns_to_items_.py
+    └── f25407aec7a2_set_default_values_for_existing_items.py
+```
+
+### 마이그레이션 예시
+
+#### 1. 스키마 마이그레이션 (자동 생성)
+
+```python
+# alembic/versions/211d1fe6d912_add_price_and_stock_columns_to_items_.py
+def upgrade() -> None:
+    op.add_column('items', sa.Column('price', sa.Numeric(precision=10, scale=2), nullable=True))
+    op.add_column('items', sa.Column('stock', sa.Integer(), nullable=True))
+
+def downgrade() -> None:
+    op.drop_column('items', 'stock')
+    op.drop_column('items', 'price')
+```
+
+#### 2. 데이터 마이그레이션 (수동 작성)
+
+```python
+# alembic/versions/f25407aec7a2_set_default_values_for_existing_items.py
+def upgrade() -> None:
+    op.execute("UPDATE items SET stock = 0 WHERE stock IS NULL")
+    op.execute("UPDATE items SET price = 1000.00 WHERE price IS NULL")
+
+def downgrade() -> None:
+    pass  # 데이터 마이그레이션은 롤백이 어려움
+```
+
+### 무중단 배포와 마이그레이션
+
+배포 스크립트([deploy.sh](deploy.sh))는 자동으로 마이그레이션을 실행합니다:
+
+```
+1. 이미지 빌드
+2. 데이터베이스 마이그레이션 실행 ← alembic upgrade head
+3. app1 배포
+4. app2 배포
+```
+
+**하위 호환 마이그레이션 원칙:**
+- ✅ 컬럼 추가는 `nullable=True`로 설정
+- ✅ 인덱스 추가는 안전
+- ⚠️ 컬럼 삭제, NOT NULL 제약은 2단계 배포 필요
+
+### 트러블슈팅
+
+#### 마이그레이션 충돌
+
+```bash
+# 현재 상태 확인
+alembic current
+
+# 마이그레이션 히스토리 확인
+alembic history
+
+# 특정 리비전으로 강제 설정 (주의!)
+alembic stamp <revision_id>
+```
+
+#### 마이그레이션 실패 시
+
+마이그레이션은 트랜잭션 내에서 실행되므로 실패 시 자동 롤백됩니다. 하지만 배포는 중단되므로:
+
+1. 오류 로그 확인
+2. 마이그레이션 파일 수정
+3. 다시 배포 실행
+
+더 자세한 학습 내용은 [plan.md](plan.md)의 "6단계: Alembic 데이터베이스 마이그레이션" 섹션을 참고하세요.