feat: 스키마 변경 - price, stock 컬럼 추가

- Item 모델에 price(Numeric), stock(Integer) 컬럼 추가
- ItemBase 스키마 업데이트 (Decimal 타입 사용)
- 마이그레이션 생성 및 적용 테스트 완료
- plan.md에 스키마 변경 실습 과정 상세 문서화

학습 내용:
- alembic revision --autogenerate로 모델 변경 자동 감지
- nullable=True 사용으로 기존 데이터 호환성 유지
- upgrade/downgrade 테스트로 양방향 마이그레이션 검증
- alembic current, history 명령어로 상태 확인

실습 결과:
- upgrade: 0fee3ec0c79f -> 211d1fe6d912 성공
- downgrade: 211d1fe6d912 -> 0fee3ec0c79f 성공
- 마이그레이션 체인이 정상적으로 연결됨

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

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

Author: f-lab-piz

alembic/versions/211d1fe6d912_add_price_and_stock_columns_to_items_.py

@@ -0,0 +1,30 @@
+"""Add price and stock columns to items table
+
+Revision ID: 211d1fe6d912
+Revises: 0fee3ec0c79f
+Create Date: 2025-10-10 02:48:51.243684
+
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision = '211d1fe6d912'
+down_revision = '0fee3ec0c79f'
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    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))
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column('items', 'stock')
+    op.drop_column('items', 'price')
+    # ### end Alembic commands ###

app/models.py

@@ -1,4 +1,4 @@
-from sqlalchemy import Column, Integer, String, DateTime
+from sqlalchemy import Column, Integer, String, DateTime, Numeric
 from sqlalchemy.sql import func
 from app.database import Base
 
@@ -8,5 +8,7 @@ class Item(Base):
     id = Column(Integer, primary_key=True, index=True)
     name = Column(String, index=True)
     description = Column(String)
+    price = Column(Numeric(10, 2), nullable=True)  # 가격: 최대 10자리, 소수점 2자리
+    stock = Column(Integer, default=0)  # 재고: 기본값 0
     created_at = Column(DateTime(timezone=True), server_default=func.now())
     updated_at = Column(DateTime(timezone=True), onupdate=func.now())

app/schemas.py

@@ -1,10 +1,13 @@
 from pydantic import BaseModel
 from datetime import datetime
 from typing import Optional
+from decimal import Decimal
 
 class ItemBase(BaseModel):
     name: str
     description: Optional[str] = None
+    price: Optional[Decimal] = None
+    stock: int = 0
 
 class ItemCreate(ItemBase):
     pass

plan.md

@@ -101,10 +101,63 @@ alembic history
 - created_at, updated_at 타임스탬프
 - name, id에 인덱스 생성
 
-#### 6-2. 스키마 변경 실습
-- [ ] Item 모델에 컬럼 추가 (price, stock)
-- [ ] 마이그레이션 생성 및 적용
-- [ ] upgrade/downgrade 테스트
+#### 6-2. 스키마 변경 실습 ✅
+스키마 변경과 마이그레이션 생성 과정을 실습했습니다.
+
+**변경 내용:**
+- Item 모델에 컬럼 추가
+  - `price`: Numeric(10, 2) - 가격 필드, nullable
+  - `stock`: Integer - 재고 필드, 기본값 0
+- schemas.py도 함께 업데이트 (Decimal 타입 사용)
+
+**마이그레이션 생성 과정:**
+```bash
+# 1. 먼저 기존 마이그레이션을 DB에 적용
+alembic upgrade head
+
+# 2. 모델 변경 후 새 마이그레이션 생성
+alembic revision --autogenerate -m "Add price and stock columns to items table"
+```
+
+**Alembic이 자동으로 감지한 변경 사항:**
+- Detected added column 'items.price'
+- Detected added column 'items.stock'
+
+**생성된 마이그레이션 (211d1fe6d912):**
+```python
+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')
+```
+
+**upgrade/downgrade 테스트:**
+```bash
+# 마이그레이션 적용
+alembic upgrade head
+# 출력: Running upgrade 0fee3ec0c79f -> 211d1fe6d912
+
+# 현재 버전 확인
+alembic current
+# 출력: 211d1fe6d912 (head)
+
+# 한 단계 롤백
+alembic downgrade -1
+# 출력: Running downgrade 211d1fe6d912 -> 0fee3ec0c79f
+
+# 다시 최신 버전으로
+alembic upgrade head
+# 출력: Running upgrade 0fee3ec0c79f -> 211d1fe6d912
+```
+
+**학습 포인트:**
+- `--autogenerate`는 모델 변경을 자동 감지하지만 항상 검토 필요
+- nullable=True로 생성하여 기존 데이터와 호환성 유지
+- down_revision이 자동으로 이전 마이그레이션을 참조
+- upgrade/downgrade가 정확히 반대 동작 수행
 
 #### 6-3. 무중단 배포 통합
 - [ ] deploy.sh에 마이그레이션 자동화