"feat: Phase 1 완료 - 데이터베이스 및 백엔드 기초 구축

- SQLAlchemy ORM 모델 (12개 테이블)
- Pydantic 스키마 (요청/응답 검증)
- CRUD 헬퍼 함수
- FastAPI 메인 애플리케이션
- 데이터베이스 연결 설정
- 환경 변수 템플릿 (.env.example)
- 팀 협업 가이드 (SETUP.md)

.env.example

@@ -0,0 +1,55 @@
+# ============================================================================
+# SmartEyeSsen Backend Environment Variables
+# ============================================================================
+# 이 파일을 복사하여 .env 파일을 생성하고 실제 값으로 변경하세요.
+# 명령어: cp .env.example .env
+
+# ============================================================================
+# 데이터베이스 설정 (MySQL)
+# ============================================================================
+DB_HOST=localhost
+DB_PORT=3306
+DB_USER=root
+DB_PASSWORD=your_password_here
+DB_NAME=smarteyessen_db
+
+# 데이터베이스 URL (자동 생성, 수동 변경 불필요)
+DATABASE_URL=mysql+pymysql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
+
+# ============================================================================
+# FastAPI 설정
+# ============================================================================
+API_HOST=0.0.0.0
+API_PORT=8000
+API_RELOAD=True
+API_LOG_LEVEL=info
+
+# ============================================================================
+# OpenAI API 설정 (선택사항)
+# ============================================================================
+OPENAI_API_KEY=your_openai_api_key_here
+
+# ============================================================================
+# 파일 업로드 설정
+# ============================================================================
+UPLOAD_DIR=uploads
+MAX_FILE_SIZE=10485760  # 10MB (바이트 단위)
+ALLOWED_EXTENSIONS=jpg,jpeg,png,pdf
+
+# ============================================================================
+# 보안 설정 (JWT - 선택사항)
+# ============================================================================
+SECRET_KEY=your_secret_key_here_change_in_production
+ALGORITHM=HS256
+ACCESS_TOKEN_EXPIRE_MINUTES=30
+
+# ============================================================================
+# CORS 설정
+# ============================================================================
+CORS_ORIGINS=http://localhost:3000,http://localhost:8080
+
+# ============================================================================
+# 기타 설정
+# ============================================================================
+DEBUG=True
+ENVIRONMENT=development

README.md

@@ -0,0 +1,263 @@
+# SmartEyeSsen Backend
+
+시각장애 학생을 위한 AI 기반 학습 자료 분석 시스템 - 백엔드 서버
+
+## 🚀 빠른 시작
+
+### 1. 환경 설정
+
+```bash
+# .env 파일 생성
+cp .env.example .env
+
+# .env 파일 편집 (DB 비밀번호 등 설정)
+notepad .env
+```
+
+### 2. 가상환경 생성 및 활성화
+
+```bash
+# 가상환경 생성
+python -m venv venv
+
+# 가상환경 활성화 (Windows)
+venv\Scripts\activate
+
+# 가상환경 활성화 (Linux/Mac)
+source venv/bin/activate
+```
+
+### 3. 의존성 설치
+
+```bash
+pip install -r requirements.txt
+```
+
+### 4. 데이터베이스 설정
+
+MySQL 8.0 이상 필요:
+
+```sql
+-- MySQL에 데이터베이스 생성
+CREATE DATABASE smarteyessen_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+-- 사용자 권한 설정 (선택사항)
+GRANT ALL PRIVILEGES ON smarteyessen_db.* TO 'your_user'@'localhost';
+FLUSH PRIVILEGES;
+```
+
+### 5. 서버 실행
+
+**방법 1: 배치 파일 사용 (Windows)**
+```bash
+start_server.bat
+```
+
+**방법 2: 직접 실행**
+```bash
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+**방법 3: Python 스크립트 실행**
+```bash
+python -m app.main
+```
+
+### 6. API 문서 확인
+
+서버 실행 후 브라우저에서 접속:
+
+- **Swagger UI**: http://localhost:8000/docs
+- **ReDoc**: http://localhost:8000/redoc
+- **Health Check**: http://localhost:8000/health
+
+---
+
+## 📁 프로젝트 구조
+
+```
+Backend/
+├── .env.example          # 환경 변수 템플릿
+├── .env                  # 환경 변수 (git에서 제외)
+├── requirements.txt      # Python 의존성
+├── start_server.bat      # 서버 실행 스크립트 (Windows)
+├── README.md            # 이 파일
+│
+├── app/                 # 메인 애플리케이션
+│   ├── __init__.py     # 패키지 초기화
+│   ├── main.py         # FastAPI 앱 설정
+│   ├── database.py     # 데이터베이스 연결
+│   ├── models.py       # SQLAlchemy ORM 모델
+│   ├── schemas.py      # Pydantic 스키마
+│   ├── crud.py         # CRUD 헬퍼 함수
+│   │
+│   └── routers/        # API 라우터
+│       └── __init__.py
+│
+└── uploads/            # 업로드된 파일 저장
+```
+
+---
+
+## 🗄️ 데이터베이스 스키마
+
+### 12개 테이블 구조
+
+| # | 테이블명 | 설명 |
+|---|---------|------|
+| 1 | `users` | 사용자 정보 |
+| 2 | `document_types` | 문서 유형 (worksheet/document) |
+| 3 | `projects` | 프로젝트 (다중 페이지 문서) |
+| 4 | `pages` | 페이지 정보 |
+| 5 | `layout_elements` | 레이아웃 요소 (DocLayout-YOLO) |
+| 6 | `text_contents` | 텍스트 내용 (OCR 결과) |
+| 7 | `ai_descriptions` | AI 생성 설명 (figure/table) |
+| 8 | `question_groups` | 문제 그룹 (worksheet 전용) |
+| 9 | `question_elements` | 문제 요소 (worksheet 전용) |
+| 10 | `text_versions` | 텍스트 버전 관리 |
+| 11 | `formatting_rules` | 서식 규칙 |
+| 12 | `combined_results` | 통합 결과 (최종 문서) |
+
+### 주요 관계
+
+- **User (1) → (N) Project**: 사용자는 여러 프로젝트 소유
+- **Project (1) → (N) Page**: 프로젝트는 여러 페이지 포함
+- **Page (1) → (N) LayoutElement**: 페이지는 여러 레이아웃 요소 포함
+- **LayoutElement (1) → (1) TextContent**: 1:1 관계
+- **LayoutElement (1) → (1) AIDescription**: 1:1 관계
+- **TextContent (1) → (N) TextVersion**: 버전 관리
+
+---
+
+## 🔧 API 엔드포인트 (Phase 2에서 추가 예정)
+
+### 사용자 관리
+- `POST /api/v1/users` - 사용자 생성
+- `GET /api/v1/users/{user_id}` - 사용자 조회
+- `PUT /api/v1/users/{user_id}` - 사용자 수정
+- `DELETE /api/v1/users/{user_id}` - 사용자 삭제
+
+### 프로젝트 관리
+- `POST /api/v1/projects` - 프로젝트 생성
+- `GET /api/v1/projects` - 프로젝트 목록
+- `GET /api/v1/projects/{project_id}` - 프로젝트 상세
+- `PUT /api/v1/projects/{project_id}` - 프로젝트 수정
+- `DELETE /api/v1/projects/{project_id}` - 프로젝트 삭제
+
+### 페이지 관리
+- `POST /api/v1/pages` - 페이지 생성 (이미지 업로드)
+- `GET /api/v1/pages/{page_id}` - 페이지 조회
+- `DELETE /api/v1/pages/{page_id}` - 페이지 삭제
+
+### 레이아웃 분석
+- `POST /api/v1/analyze/layout` - 레이아웃 분석 (DocLayout-YOLO)
+- `POST /api/v1/analyze/ocr` - OCR 실행 (PaddleOCR)
+- `POST /api/v1/analyze/describe` - AI 설명 생성 (GPT-4o-mini)
+
+### 텍스트 편집
+- `PUT /api/v1/text/{content_id}` - 텍스트 수정
+- `GET /api/v1/text/{content_id}/versions` - 버전 히스토리
+
+### 문서 생성
+- `POST /api/v1/export/docx` - DOCX 문서 생성
+- `POST /api/v1/export/pdf` - PDF 문서 생성
+
+---
+
+## 🧪 개발 도구
+
+### 데이터베이스 연결 테스트
+
+```bash
+python app/database.py
+```
+
+### 데이터베이스 마이그레이션 (Alembic)
+
+```bash
+# 초기화
+alembic init alembic
+
+# 마이그레���션 파일 생성
+alembic revision --autogenerate -m "Initial migration"
+
+# 마이그레이션 적용
+alembic upgrade head
+
+# 롤백
+alembic downgrade -1
+```
+
+---
+
+## 📝 환경 변수 설명
+
+| 변수명 | 설명 | 기본값 |
+|--------|------|--------|
+| `DB_HOST` | MySQL 호스트 | `localhost` |
+| `DB_PORT` | MySQL 포트 | `3306` |
+| `DB_USER` | MySQL 사용자명 | `root` |
+| `DB_PASSWORD` | MySQL 비밀번호 | - |
+| `DB_NAME` | 데이터베이스 이름 | `smarteyessen_db` |
+| `API_HOST` | API 서버 호스트 | `0.0.0.0` |
+| `API_PORT` | API 서버 포트 | `8000` |
+| `CORS_ORIGINS` | CORS 허용 출처 | `http://localhost:3000` |
+| `OPENAI_API_KEY` | OpenAI API 키 | - |
+| `ENVIRONMENT` | 환경 (development/production) | `development` |
+
+---
+
+## 🐛 문제 해결
+
+### 1. 데이터베이스 연결 실패
+
+```bash
+# MySQL 서비스 확인
+net start MySQL80
+
+# .env 파일의 DB 설정 확인
+DB_PASSWORD=your_actual_password
+```
+
+### 2. 포트 충돌
+
+```bash
+# 다른 포트로 실행
+uvicorn app.main:app --reload --port 8001
+```
+
+### 3. 의존성 설치 오류
+
+```bash
+# pip 업그레이드
+python -m pip install --upgrade pip
+
+# 캐시 삭제 후 재설치
+pip cache purge
+pip install -r requirements.txt
+```
+
+---
+
+## 📚 참고 자료
+
+- [FastAPI 공식 문서](https://fastapi.tiangolo.com/)
+- [SQLAlchemy 공식 문서](https://www.sqlalchemy.org/)
+- [Pydantic 공식 문서](https://docs.pydantic.dev/)
+- [MySQL 8.0 문서](https://dev.mysql.com/doc/refman/8.0/en/)
+
+---
+
+## 📄 라이선스
+
+MIT License
+
+---
+
+## 👥 개발팀
+
+SmartEyeSsen Team - 시각장애 학생을 위한 AI 학습 도구
+
+---
+
+**Phase 1 완료**: 데이터베이스 및 백엔드 기반 구축 ✅

app/__init__.py

@@ -0,0 +1,8 @@
+"""
+SmartEyeSsen Backend - Application Package
+==========================================
+FastAPI 백엔드 애플리케이션 패키지 초기화
+"""
+
+__version__ = "1.0.0"
+__author__ = "SmartEyeSsen Team"

app/crud.py

@@ -0,0 +1,537 @@
+"""
+SmartEyeSsen Backend - CRUD Helper Functions
+=============================================
+데이터베이스 CRUD 작업을 위한 헬퍼 함수
+
+주요 기능:
+- Create: 새 레코드 생성
+- Read: 단일/다중 레코드 조회
+- Update: 기존 레코드 수정
+- Delete: 레코드 삭제
+"""
+
+from sqlalchemy.orm import Session, joinedload
+from sqlalchemy import desc, asc
+from typing import Optional, List, Type, TypeVar
+from . import models, schemas
+from passlib.context import CryptContext
+
+# 비밀번호 해싱 설정
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+# TypeVar for generic CRUD operations
+ModelType = TypeVar("ModelType")
+CreateSchemaType = TypeVar("CreateSchemaType")
+UpdateSchemaType = TypeVar("UpdateSchemaType")
+
+
+# ============================================================================
+# 1. User CRUD
+# ============================================================================
+def get_user(db: Session, user_id: int) -> Optional[models.User]:
+    """사용자 ID로 조회"""
+    return db.query(models.User).filter(models.User.user_id == user_id).first()
+
+
+def get_user_by_username(db: Session, username: str) -> Optional[models.User]:
+    """사용자명으로 조회"""
+    return db.query(models.User).filter(models.User.username == username).first()
+
+
+def get_user_by_email(db: Session, email: str) -> Optional[models.User]:
+    """이메일로 조회"""
+    return db.query(models.User).filter(models.User.email == email).first()
+
+
+def get_users(db: Session, skip: int = 0, limit: int = 100) -> List[models.User]:
+    """사용자 목록 조회"""
+    return db.query(models.User).offset(skip).limit(limit).all()
+
+
+def create_user(db: Session, user: schemas.UserCreate) -> models.User:
+    """사용자 생성"""
+    hashed_password = pwd_context.hash(user.password)
+    db_user = models.User(
+        username=user.username,
+        email=user.email,
+        password_hash=hashed_password
+    )
+    db.add(db_user)
+    db.commit()
+    db.refresh(db_user)
+    return db_user
+
+
+def update_user(db: Session, user_id: int, user_update: schemas.UserUpdate) -> Optional[models.User]:
+    """사용자 정보 수정"""
+    db_user = get_user(db, user_id)
+    if not db_user:
+        return None
+    
+    update_data = user_update.model_dump(exclude_unset=True)
+    if "password" in update_data:
+        update_data["password_hash"] = pwd_context.hash(update_data.pop("password"))
+    
+    for key, value in update_data.items():
+        setattr(db_user, key, value)
+    
+    db.commit()
+    db.refresh(db_user)
+    return db_user
+
+
+def delete_user(db: Session, user_id: int) -> bool:
+    """사용자 삭제"""
+    db_user = get_user(db, user_id)
+    if not db_user:
+        return False
+    db.delete(db_user)
+    db.commit()
+    return True
+
+
+# ============================================================================
+# 2. DocumentType CRUD
+# ============================================================================
+def get_document_type(db: Session, type_id: int) -> Optional[models.DocumentType]:
+    """문서 유형 ID로 조회"""
+    return db.query(models.DocumentType).filter(models.DocumentType.type_id == type_id).first()
+
+
+def get_document_type_by_name(db: Session, type_name: str) -> Optional[models.DocumentType]:
+    """문서 유형명으로 조회"""
+    return db.query(models.DocumentType).filter(models.DocumentType.type_name == type_name).first()
+
+
+def get_document_types(db: Session) -> List[models.DocumentType]:
+    """모든 문서 유형 조회"""
+    return db.query(models.DocumentType).all()
+
+
+def create_document_type(db: Session, doc_type: schemas.DocumentTypeCreate) -> models.DocumentType:
+    """문서 유형 생성"""
+    db_doc_type = models.DocumentType(**doc_type.model_dump())
+    db.add(db_doc_type)
+    db.commit()
+    db.refresh(db_doc_type)
+    return db_doc_type
+
+
+# ============================================================================
+# 3. Project CRUD
+# ============================================================================
+def get_project(db: Session, project_id: int) -> Optional[models.Project]:
+    """프로젝트 ID로 조회"""
+    return db.query(models.Project).filter(models.Project.project_id == project_id).first()
+
+
+def get_project_with_pages(db: Session, project_id: int) -> Optional[models.Project]:
+    """페이지 포함 프로젝트 조회"""
+    return db.query(models.Project).options(
+        joinedload(models.Project.pages)
+    ).filter(models.Project.project_id == project_id).first()
+
+
+def get_projects_by_user(
+    db: Session,
+    user_id: int,
+    skip: int = 0,
+    limit: int = 100
+) -> List[models.Project]:
+    """사용자별 프로젝트 목록 조회"""
+    return db.query(models.Project).filter(
+        models.Project.user_id == user_id
+    ).order_by(desc(models.Project.created_at)).offset(skip).limit(limit).all()
+
+
+def create_project(db: Session, project: schemas.ProjectCreate, user_id: int) -> models.Project:
+    """프로젝트 생성"""
+    db_project = models.Project(**project.model_dump(), user_id=user_id)
+    db.add(db_project)
+    db.commit()
+    db.refresh(db_project)
+    return db_project
+
+
+def update_project(
+    db: Session,
+    project_id: int,
+    project_update: schemas.ProjectUpdate
+) -> Optional[models.Project]:
+    """프로젝트 수정"""
+    db_project = get_project(db, project_id)
+    if not db_project:
+        return None
+    
+    update_data = project_update.model_dump(exclude_unset=True)
+    for key, value in update_data.items():
+        setattr(db_project, key, value)
+    
+    db.commit()
+    db.refresh(db_project)
+    return db_project
+
+
+def delete_project(db: Session, project_id: int) -> bool:
+    """프로젝트 삭제 (CASCADE로 관련 데이터 자동 삭제)"""
+    db_project = get_project(db, project_id)
+    if not db_project:
+        return False
+    db.delete(db_project)
+    db.commit()
+    return True
+
+
+# ============================================================================
+# 4. Page CRUD
+# ============================================================================
+def get_page(db: Session, page_id: int) -> Optional[models.Page]:
+    """페이지 ID로 조회"""
+    return db.query(models.Page).filter(models.Page.page_id == page_id).first()
+
+
+def get_page_with_elements(db: Session, page_id: int) -> Optional[models.Page]:
+    """레이아웃 요소 포함 페이지 조회"""
+    return db.query(models.Page).options(
+        joinedload(models.Page.layout_elements)
+    ).filter(models.Page.page_id == page_id).first()
+
+
+def get_pages_by_project(db: Session, project_id: int) -> List[models.Page]:
+    """프로젝트별 페이지 목록 조회 (페이지 번호 순)"""
+    return db.query(models.Page).filter(
+        models.Page.project_id == project_id
+    ).order_by(asc(models.Page.page_number)).all()
+
+
+def create_page(db: Session, page: schemas.PageCreate) -> models.Page:
+    """페이지 생성"""
+    db_page = models.Page(**page.model_dump())
+    db.add(db_page)
+    db.commit()
+    db.refresh(db_page)
+    return db_page
+
+
+def update_page(db: Session, page_id: int, page_update: schemas.PageUpdate) -> Optional[models.Page]:
+    """페이지 수정"""
+    db_page = get_page(db, page_id)
+    if not db_page:
+        return None
+    
+    update_data = page_update.model_dump(exclude_unset=True)
+    for key, value in update_data.items():
+        setattr(db_page, key, value)
+    
+    db.commit()
+    db.refresh(db_page)
+    return db_page
+
+
+def delete_page(db: Session, page_id: int) -> bool:
+    """페이지 삭제"""
+    db_page = get_page(db, page_id)
+    if not db_page:
+        return False
+    db.delete(db_page)
+    db.commit()
+    return True
+
+
+# ============================================================================
+# 5. LayoutElement CRUD
+# ============================================================================
+def get_layout_element(db: Session, element_id: int) -> Optional[models.LayoutElement]:
+    """레이아웃 요소 ID로 조회"""
+    return db.query(models.LayoutElement).filter(
+        models.LayoutElement.element_id == element_id
+    ).first()
+
+
+def get_layout_element_with_content(db: Session, element_id: int) -> Optional[models.LayoutElement]:
+    """텍스트 및 AI 설명 포함 레이아웃 요소 조회"""
+    return db.query(models.LayoutElement).options(
+        joinedload(models.LayoutElement.text_content),
+        joinedload(models.LayoutElement.ai_description)
+    ).filter(models.LayoutElement.element_id == element_id).first()
+
+
+def get_layout_elements_by_page(db: Session, page_id: int) -> List[models.LayoutElement]:
+    """페이지별 레이아웃 요소 목록 조회 (Y 좌표 순)"""
+    return db.query(models.LayoutElement).filter(
+        models.LayoutElement.page_id == page_id
+    ).order_by(asc(models.LayoutElement.y_position)).all()
+
+
+def create_layout_element(db: Session, element: schemas.LayoutElementCreate) -> models.LayoutElement:
+    """레이아웃 요소 생성"""
+    db_element = models.LayoutElement(**element.model_dump())
+    db.add(db_element)
+    db.commit()
+    db.refresh(db_element)
+    return db_element
+
+
+def create_layout_elements_bulk(
+    db: Session,
+    elements: List[schemas.LayoutElementCreate]
+) -> List[models.LayoutElement]:
+    """레이아웃 요소 일괄 생성"""
+    db_elements = [models.LayoutElement(**elem.model_dump()) for elem in elements]
+    db.add_all(db_elements)
+    db.commit()
+    for elem in db_elements:
+        db.refresh(elem)
+    return db_elements
+
+
+def update_layout_element(
+    db: Session,
+    element_id: int,
+    element_update: schemas.LayoutElementUpdate
+) -> Optional[models.LayoutElement]:
+    """레이아웃 요소 수정"""
+    db_element = get_layout_element(db, element_id)
+    if not db_element:
+        return None
+    
+    update_data = element_update.model_dump(exclude_unset=True)
+    for key, value in update_data.items():
+        setattr(db_element, key, value)
+    
+    db.commit()
+    db.refresh(db_element)
+    return db_element
+
+
+def delete_layout_element(db: Session, element_id: int) -> bool:
+    """레이아웃 요소 삭제"""
+    db_element = get_layout_element(db, element_id)
+    if not db_element:
+        return False
+    db.delete(db_element)
+    db.commit()
+    return True
+
+
+# ============================================================================
+# 6. TextContent CRUD
+# ============================================================================
+def get_text_content(db: Session, content_id: int) -> Optional[models.TextContent]:
+    """텍스트 내용 ID로 조회"""
+    return db.query(models.TextContent).filter(
+        models.TextContent.content_id == content_id
+    ).first()
+
+
+def get_text_content_by_element(db: Session, element_id: int) -> Optional[models.TextContent]:
+    """요소 ID로 텍스트 내용 조회"""
+    return db.query(models.TextContent).filter(
+        models.TextContent.element_id == element_id
+    ).first()
+
+
+def create_text_content(db: Session, content: schemas.TextContentCreate) -> models.TextContent:
+    """텍스트 내용 생성"""
+    db_content = models.TextContent(**content.model_dump())
+    db.add(db_content)
+    db.commit()
+    db.refresh(db_content)
+    return db_content
+
+
+def update_text_content(
+    db: Session,
+    content_id: int,
+    content_update: schemas.TextContentUpdate
+) -> Optional[models.TextContent]:
+    """텍스트 내용 수정 (버전 자동 증가)"""
+    db_content = get_text_content(db, content_id)
+    if not db_content:
+        return None
+    
+    # 이전 버전 저장
+    if db_content.edited_text:
+        version = models.TextVersion(
+            content_id=content_id,
+            version_number=db_content.version,
+            version_text=db_content.edited_text
+        )
+        db.add(version)
+    
+    # 새 버전으로 업데이트
+    update_data = content_update.model_dump(exclude_unset=True)
+    for key, value in update_data.items():
+        setattr(db_content, key, value)
+    
+    db_content.version += 1
+    from datetime import datetime
+    db_content.last_edited_at = datetime.now()
+    
+    db.commit()
+    db.refresh(db_content)
+    return db_content
+
+
+# ============================================================================
+# 7. AIDescription CRUD
+# ============================================================================
+def get_ai_description(db: Session, description_id: int) -> Optional[models.AIDescription]:
+    """AI 설명 ID로 조회"""
+    return db.query(models.AIDescription).filter(
+        models.AIDescription.description_id == description_id
+    ).first()
+
+
+def get_ai_description_by_element(db: Session, element_id: int) -> Optional[models.AIDescription]:
+    """요소 ID로 AI 설명 조회"""
+    return db.query(models.AIDescription).filter(
+        models.AIDescription.element_id == element_id
+    ).first()
+
+
+def create_ai_description(db: Session, description: schemas.AIDescriptionCreate) -> models.AIDescription:
+    """AI 설명 생성"""
+    db_description = models.AIDescription(**description.model_dump())
+    db.add(db_description)
+    db.commit()
+    db.refresh(db_description)
+    return db_description
+
+
+# ============================================================================
+# 8. QuestionGroup CRUD
+# ============================================================================
+def get_question_group(db: Session, group_id: int) -> Optional[models.QuestionGroup]:
+    """문제 그룹 ID로 조회"""
+    return db.query(models.QuestionGroup).filter(
+        models.QuestionGroup.group_id == group_id
+    ).first()
+
+
+def get_question_groups_by_page(db: Session, page_id: int) -> List[models.QuestionGroup]:
+    """페이지별 문제 그룹 목록 조회"""
+    return db.query(models.QuestionGroup).filter(
+        models.QuestionGroup.page_id == page_id
+    ).order_by(asc(models.QuestionGroup.group_number)).all()
+
+
+def create_question_group(db: Session, group: schemas.QuestionGroupCreate) -> models.QuestionGroup:
+    """문제 그룹 생성"""
+    db_group = models.QuestionGroup(**group.model_dump())
+    db.add(db_group)
+    db.commit()
+    db.refresh(db_group)
+    return db_group
+
+
+# ============================================================================
+# 9. QuestionElement CRUD
+# ============================================================================
+def get_question_element(db: Session, question_element_id: int) -> Optional[models.QuestionElement]:
+    """문제 요소 ID로 조회"""
+    return db.query(models.QuestionElement).filter(
+        models.QuestionElement.question_element_id == question_element_id
+    ).first()
+
+
+def get_question_elements_by_group(db: Session, group_id: int) -> List[models.QuestionElement]:
+    """그룹별 문제 요소 목록 조회"""
+    return db.query(models.QuestionElement).filter(
+        models.QuestionElement.group_id == group_id
+    ).order_by(asc(models.QuestionElement.element_order)).all()
+
+
+def create_question_element(db: Session, element: schemas.QuestionElementCreate) -> models.QuestionElement:
+    """문제 요소 생성"""
+    db_element = models.QuestionElement(**element.model_dump())
+    db.add(db_element)
+    db.commit()
+    db.refresh(db_element)
+    return db_element
+
+
+# ============================================================================
+# 10. FormattingRule CRUD
+# ============================================================================
+def get_formatting_rule(db: Session, rule_id: int) -> Optional[models.FormattingRule]:
+    """서식 규칙 ID로 조회"""
+    return db.query(models.FormattingRule).filter(
+        models.FormattingRule.rule_id == rule_id
+    ).first()
+
+
+def get_formatting_rule_by_type(db: Session, element_type: str) -> Optional[models.FormattingRule]:
+    """요소 유형으로 서식 규칙 조회"""
+    return db.query(models.FormattingRule).filter(
+        models.FormattingRule.element_type == element_type
+    ).first()
+
+
+def get_all_formatting_rules(db: Session) -> List[models.FormattingRule]:
+    """모든 서식 규칙 조회"""
+    return db.query(models.FormattingRule).all()
+
+
+def create_formatting_rule(db: Session, rule: schemas.FormattingRuleCreate) -> models.FormattingRule:
+    """서식 규칙 생성"""
+    db_rule = models.FormattingRule(**rule.model_dump())
+    db.add(db_rule)
+    db.commit()
+    db.refresh(db_rule)
+    return db_rule
+
+
+def update_formatting_rule(
+    db: Session,
+    rule_id: int,
+    rule_update: schemas.FormattingRuleUpdate
+) -> Optional[models.FormattingRule]:
+    """서식 규칙 수정"""
+    db_rule = get_formatting_rule(db, rule_id)
+    if not db_rule:
+        return None
+    
+    update_data = rule_update.model_dump(exclude_unset=True)
+    for key, value in update_data.items():
+        setattr(db_rule, key, value)
+    
+    db.commit()
+    db.refresh(db_rule)
+    return db_rule
+
+
+# ============================================================================
+# 11. CombinedResult CRUD
+# ============================================================================
+def get_combined_result(db: Session, result_id: int) -> Optional[models.CombinedResult]:
+    """통합 결과 ID로 조회"""
+    return db.query(models.CombinedResult).filter(
+        models.CombinedResult.result_id == result_id
+    ).first()
+
+
+def get_combined_results_by_project(db: Session, project_id: int) -> List[models.CombinedResult]:
+    """프로젝트별 통합 결과 목록 조회"""
+    return db.query(models.CombinedResult).filter(
+        models.CombinedResult.project_id == project_id
+    ).order_by(desc(models.CombinedResult.generated_at)).all()
+
+
+def create_combined_result(db: Session, result: schemas.CombinedResultCreate) -> models.CombinedResult:
+    """통합 결과 생성"""
+    db_result = models.CombinedResult(**result.model_dump())
+    db.add(db_result)
+    db.commit()
+    db.refresh(db_result)
+    return db_result
+
+
+def delete_combined_result(db: Session, result_id: int) -> bool:
+    """통합 결과 삭제"""
+    db_result = get_combined_result(db, result_id)
+    if not db_result:
+        return False
+    db.delete(db_result)
+    db.commit()
+    return True

app/database.py

@@ -0,0 +1,173 @@
+"""
+SmartEyeSsen Backend - Database Connection Configuration
+=========================================================
+SQLAlchemy 엔진, 세션 관리 및 Base 클래스 정의
+
+주요 기능:
+- MySQL 데이터베이스 연결 설정
+- 세션 생성 및 의존성 주입
+- 비동기 컨텍스트 매니저 지원
+"""
+
+from sqlalchemy import create_engine, event, text
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker, Session
+from typing import Generator
+import os
+from dotenv import load_dotenv
+
+# ============================================================================
+# 환경 변수 로드
+# ============================================================================
+load_dotenv()
+
+# ============================================================================
+# 데이터베이스 설정
+# ============================================================================
+DB_HOST = os.getenv("DB_HOST", "localhost")
+DB_PORT = os.getenv("DB_PORT", "3306")
+DB_USER = os.getenv("DB_USER", "root")
+DB_PASSWORD = os.getenv("DB_PASSWORD", "")
+DB_NAME = os.getenv("DB_NAME", "smarteyessen_db")
+
+# MySQL 연결 URL 생성
+# pymysql 드라이버 사용, charset=utf8mb4 설정
+SQLALCHEMY_DATABASE_URL = (
+    f"mysql+pymysql://{DB_USER}:{DB_PASSWORD}@{DB_HOST}:{DB_PORT}/{DB_NAME}"
+    f"?charset=utf8mb4"
+)
+
+# ============================================================================
+# SQLAlchemy Engine 생성
+# ============================================================================
+engine = create_engine(
+    SQLALCHEMY_DATABASE_URL,
+    # 연결 풀 설정
+    pool_size=10,  # 기본 연결 수
+    max_overflow=20,  # 추가 가능한 최대 연결 수
+    pool_pre_ping=True,  # 연결 유효성 자동 체크
+    pool_recycle=3600,  # 1시간마다 연결 재생성
+    echo=False,  # SQL 로그 출력 (개발 시 True로 변경 가능)
+)
+
+# ============================================================================
+# SessionLocal 클래스 생성
+# ============================================================================
+SessionLocal = sessionmaker(
+    autocommit=False,  # 자동 커밋 비활성화
+    autoflush=False,  # 자동 플러시 비활성화
+    bind=engine,
+)
+
+# ============================================================================
+# Base 클래스 정의
+# ============================================================================
+Base = declarative_base()
+
+# ============================================================================
+# 데이터베이스 세션 의존성 함수
+# ============================================================================
+def get_db() -> Generator[Session, None, None]:
+    """
+    FastAPI 의존성 주입용 데이터베이스 세션 생성
+    
+    사용 예시:
+    ```python
+    @app.get("/users")
+    def read_users(db: Session = Depends(get_db)):
+        users = db.query(User).all()
+        return users
+    ```
+    
+    Yields:
+        Session: SQLAlchemy 데이터베이스 세션
+    """
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()
+
+
+# ============================================================================
+# 데이터베이스 초기화 함수
+# ============================================================================
+def init_db():
+    """
+    데이터베이스 테이블 생성 (개발 환경용)
+    
+    주의: 운영 환경에서는 Alembic 마이그레이션 사용 권장
+    """
+    # models.py에서 정의한 모든 테이블 생성
+    Base.metadata.create_all(bind=engine)
+    print("✅ Database tables created successfully!")
+
+
+def drop_all_tables():
+    """
+    모든 테이블 삭제 (개발/테스트 환경용)
+    
+    ⚠️ 주의: 모든 데이터가 삭제됩니다!
+    """
+    Base.metadata.drop_all(bind=engine)
+    print("⚠️ All database tables dropped!")
+
+
+# ============================================================================
+# 데이터베이스 연결 테스트 함수
+# ============================================================================
+def test_connection():
+    """
+    데이터베이스 연결 테스트
+    
+    Returns:
+        bool: 연결 성공 여부
+    """
+    try:
+        # 간단한 쿼리 실행하여 연결 확인
+        with engine.connect() as connection:
+            result = connection.execute(text("SELECT 1"))
+            print("✅ Database connection successful!")
+            return True
+    except Exception as e:
+        print(f"❌ Database connection failed: {e}")
+        return False
+
+
+# ============================================================================
+# SQLAlchemy Event Listeners (선택사항)
+# ============================================================================
+@event.listens_for(engine, "connect")
+def set_sqlite_pragma(dbapi_conn, connection_record):
+    """
+    MySQL 연결 시 추가 설정
+    - 타임존 설정
+    - 문자셋 ���인
+    """
+    cursor = dbapi_conn.cursor()
+    # UTF-8 문자셋 강제 설정
+    cursor.execute("SET NAMES utf8mb4")
+    cursor.execute("SET CHARACTER SET utf8mb4")
+    cursor.execute("SET character_set_connection=utf8mb4")
+    cursor.close()
+
+
+# ============================================================================
+# 개발용 유틸리티
+# ============================================================================
+if __name__ == "__main__":
+    """
+    직접 실행 시 데이터베이스 연결 테스트
+    
+    실행 방법:
+    ```bash
+    python app/database.py
+    ```
+    """
+    print("=" * 60)
+    print("SmartEyeSsen Database Connection Test")
+    print("=" * 60)
+    print(f"Database URL: {SQLALCHEMY_DATABASE_URL.replace(DB_PASSWORD, '***')}")
+    print("-" * 60)
+    test_connection()
+    print("=" * 60)

app/main.py

@@ -0,0 +1,209 @@
+"""
+SmartEyeSsen Backend - FastAPI Main Application
+================================================
+FastAPI 메인 애플리케이션 및 라우터 설정
+
+주요 기능:
+- FastAPI 앱 초기화
+- CORS 설정
+- 라우터 등록
+- 데이터베이스 초기화
+- API 문서화
+"""
+
+from fastapi import FastAPI, Depends, HTTPException, status
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+from sqlalchemy.orm import Session
+import os
+from dotenv import load_dotenv
+
+from .database import engine, get_db, init_db, test_connection
+from . import models
+
+# 환경 변수 로드
+load_dotenv()
+
+# ============================================================================
+# FastAPI 앱 초기화
+# ============================================================================
+app = FastAPI(
+    title="SmartEyeSsen API",
+    description="""
+    ## SmartEyeSsen Backend API
+    
+    시각장애 학생을 위한 AI 기반 학습 자료 분석 시스템
+    
+    ### 주요 기능
+    * 📄 **다중 페이지 문서 처리**: Worksheet 및 Document 유형 지원
+    * 🤖 **AI 레이아웃 분석**: DocLayout-YOLO 기반 레이아웃 감지
+    * 🔍 **OCR 텍스트 추출**: PaddleOCR 기반 텍스트 인식
+    * ✏️ **텍스트 편집 및 버전 관리**: TinyMCE 편집기 지원
+    * 🖼️ **AI 설명 생성**: GPT-4o-mini 기반 figure/table 설명
+    * 📊 **문제 기반 정렬**: Worksheet 전용 문제 번호 기반 정렬
+    * 📐 **좌표 기반 정렬**: Document 전용 좌표 기반 정렬
+    * 📥 **통합 문서 다운로드**: DOCX/PDF/TXT 형식 지원
+    
+    ### 기술 스택
+    * **Backend**: FastAPI + SQLAlchemy
+    * **Database**: MySQL 8.0
+    * **AI Models**: DocLayout-YOLO, PaddleOCR, GPT-4o-mini
+    * **Document**: python-docx
+    """,
+    version="1.0.0",
+    docs_url="/docs",
+    redoc_url="/redoc",
+    openapi_url="/openapi.json",
+)
+
+# ============================================================================
+# CORS 설정
+# ============================================================================
+CORS_ORIGINS = os.getenv("CORS_ORIGINS", "http://localhost:3000,http://localhost:8080").split(",")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=CORS_ORIGINS,  # 허용할 출처
+    allow_credentials=True,
+    allow_methods=["*"],  # 모든 HTTP 메소드 허용
+    allow_headers=["*"],  # 모든 헤더 허용
+)
+
+# ============================================================================
+# 시작 이벤트
+# ============================================================================
+@app.on_event("startup")
+async def startup_event():
+    """
+    애플리케이션 시작 시 실행
+    - 데이터베이스 연결 테스트
+    - 테이블 생성 (개발 환경)
+    """
+    print("=" * 60)
+    print("🚀 SmartEyeSsen Backend Starting...")
+    print("=" * 60)
+    
+    # 데이터베이스 연결 테스트
+    if test_connection():
+        print("✅ Database connection successful")
+    else:
+        print("❌ Database connection failed")
+        print("⚠️ Please check your database configuration")
+    
+    # 테이블 생성 (개발 환경에서만)
+    if os.getenv("ENVIRONMENT", "development") == "development":
+        try:
+            init_db()
+            print("✅ Database tables initialized")
+        except Exception as e:
+            print(f"⚠️ Table initialization warning: {e}")
+    
+    print("=" * 60)
+    print("✅ SmartEyeSsen Backend Ready!")
+    print(f"📖 API Docs: http://localhost:{os.getenv('API_PORT', 8000)}/docs")
+    print("=" * 60)
+
+
+@app.on_event("shutdown")
+async def shutdown_event():
+    """애플리케이션 종료 시 실행"""
+    print("\n" + "=" * 60)
+    print("👋 SmartEyeSsen Backend Shutting down...")
+    print("=" * 60)
+
+
+# ============================================================================
+# 루트 엔드포인트
+# ============================================================================
+@app.get("/", tags=["Root"])
+async def root():
+    """
+    루트 엔드포인트
+    
+    서버 상태 및 기본 정보 반환
+    """
+    return {
+        "message": "Welcome to SmartEyeSsen API",
+        "version": "1.0.0",
+        "status": "running",
+        "docs": "/docs",
+        "redoc": "/redoc"
+    }
+
+
+@app.get("/health", tags=["Root"])
+async def health_check(db: Session = Depends(get_db)):
+    """
+    헬스 체크 엔드포인트
+    
+    서버 및 데이터베이스 상태 확인
+    """
+    try:
+        # 간단한 쿼리로 DB 연결 확인
+        db.execute("SELECT 1")
+        db_status = "connected"
+    except Exception as e:
+        db_status = f"error: {str(e)}"
+    
+    return {
+        "status": "healthy",
+        "database": db_status,
+        "api_version": "1.0.0"
+    }
+
+
+# ============================================================================
+# 예외 핸들러
+# ============================================================================
+@app.exception_handler(HTTPException)
+async def http_exception_handler(request, exc):
+    """HTTP 예외 핸들러"""
+    return JSONResponse(
+        status_code=exc.status_code,
+        content={
+            "error": exc.detail,
+            "status_code": exc.status_code
+        }
+    )
+
+
+@app.exception_handler(Exception)
+async def general_exception_handler(request, exc):
+    """일반 예외 핸들러"""
+    return JSONResponse(
+        status_code=500,
+        content={
+            "error": "Internal Server Error",
+            "detail": str(exc),
+            "status_code": 500
+        }
+    )
+
+
+# ============================================================================
+# 라우터 등록 (Phase 2에서 추가 예정)
+# ============================================================================
+# from .routers import users, projects, pages, layout_elements
+# app.include_router(users.router, prefix="/api/v1/users", tags=["Users"])
+# app.include_router(projects.router, prefix="/api/v1/projects", tags=["Projects"])
+# app.include_router(pages.router, prefix="/api/v1/pages", tags=["Pages"])
+# app.include_router(layout_elements.router, prefix="/api/v1/elements", tags=["Layout Elements"])
+
+
+# ============================================================================
+# 개발 서버 실행 (직접 실행 시)
+# ============================================================================
+if __name__ == "__main__":
+    import uvicorn
+    
+    HOST = os.getenv("API_HOST", "0.0.0.0")
+    PORT = int(os.getenv("API_PORT", 8000))
+    RELOAD = os.getenv("API_RELOAD", "True").lower() == "true"
+    
+    uvicorn.run(
+        "main:app",
+        host=HOST,
+        port=PORT,
+        reload=RELOAD,
+        log_level="info"
+    )

app/models.py

@@ -0,0 +1,367 @@
+"""
+SmartEyeSsen Backend - SQLAlchemy ORM Models
+============================================
+12개 테이블에 대한 SQLAlchemy 모델 정의
+
+테이블 목록:
+1. users - 사용자 정보
+2. document_types - 문서 유형 (worksheet/document)
+3. projects - 프로젝트 (문서 단위)
+4. pages - 페이지 정보
+5. layout_elements - 레이아웃 요소
+6. text_contents - 텍스트 내용
+7. ai_descriptions - AI 생성 설명
+8. question_groups - 문제 그룹
+9. question_elements - 문제 요소
+10. text_versions - 텍스트 버전 관리
+11. formatting_rules - 서식 규칙
+12. combined_results - 통합 결과
+"""
+
+from sqlalchemy import (
+    Column, Integer, String, Text, DateTime, Enum, Numeric,
+    ForeignKey, Boolean, JSON, DECIMAL, Index
+)
+from sqlalchemy.orm import relationship
+from sqlalchemy.sql import func
+from datetime import datetime
+from .database import Base
+
+
+# ============================================================================
+# 1. Users - 사용자 정보
+# ============================================================================
+class User(Base):
+    """사용자 정보 테이블"""
+    __tablename__ = "users"
+    
+    user_id = Column(Integer, primary_key=True, autoincrement=True, comment="사용자 ID")
+    username = Column(String(50), unique=True, nullable=False, comment="사용자명")
+    email = Column(String(100), unique=True, nullable=False, comment="이메일")
+    password_hash = Column(String(255), nullable=False, comment="비밀번호 해시")
+    created_at = Column(DateTime, default=func.now(), comment="생성일시")
+    last_login = Column(DateTime, nullable=True, comment="마지막 로그인")
+    
+    # 관계 설정
+    projects = relationship("Project", back_populates="user", cascade="all, delete-orphan")
+    
+    def __repr__(self):
+        return f"<User(id={self.user_id}, username='{self.username}')>"
+
+
+# ============================================================================
+# 2. Document Types - 문서 유형
+# ============================================================================
+class DocumentType(Base):
+    """문서 유형 테이블 (worksheet/document)"""
+    __tablename__ = "document_types"
+    
+    type_id = Column(Integer, primary_key=True, autoincrement=True, comment="유형 ID")
+    type_name = Column(
+        Enum('worksheet', 'document', name='document_type_enum'),
+        unique=True,
+        nullable=False,
+        comment="문서 유형"
+    )
+    description = Column(String(255), nullable=True, comment="유형 설명")
+    
+    # 관계 설정
+    projects = relationship("Project", back_populates="document_type")
+    
+    def __repr__(self):
+        return f"<DocumentType(id={self.type_id}, name='{self.type_name}')>"
+
+
+# ============================================================================
+# 3. Projects - 프로젝트 (문서 단위)
+# ============================================================================
+class Project(Base):
+    """프로젝트 테이블 (다중 페이지 문서)"""
+    __tablename__ = "projects"
+    
+    project_id = Column(Integer, primary_key=True, autoincrement=True, comment="프로젝트 ID")
+    user_id = Column(Integer, ForeignKey("users.user_id", ondelete="CASCADE"), nullable=False, comment="사용자 ID")
+    project_name = Column(String(255), nullable=False, comment="프로젝트명")
+    type_id = Column(Integer, ForeignKey("document_types.type_id", ondelete="SET NULL"), nullable=True, comment="문서 유형 ID")
+    created_at = Column(DateTime, default=func.now(), comment="생성일시")
+    updated_at = Column(DateTime, default=func.now(), onupdate=func.now(), comment="수정일시")
+    
+    # 관계 설정
+    user = relationship("User", back_populates="projects")
+    document_type = relationship("DocumentType", back_populates="projects")
+    pages = relationship("Page", back_populates="project", cascade="all, delete-orphan")
+    
+    # 인덱스
+    __table_args__ = (
+        Index("idx_user_created", "user_id", "created_at"),
+    )
+    
+    def __repr__(self):
+        return f"<Project(id={self.project_id}, name='{self.project_name}')>"
+
+
+# ============================================================================
+# 4. Pages - 페이지 정보
+# ============================================================================
+class Page(Base):
+    """페이지 정보 테이블"""
+    __tablename__ = "pages"
+    
+    page_id = Column(Integer, primary_key=True, autoincrement=True, comment="페이지 ID")
+    project_id = Column(Integer, ForeignKey("projects.project_id", ondelete="CASCADE"), nullable=False, comment="프로젝트 ID")
+    page_number = Column(Integer, nullable=False, comment="페이지 번호")
+    image_path = Column(String(512), nullable=True, comment="이미지 경로")
+    image_width = Column(Integer, nullable=True, comment="이미지 너비")
+    image_height = Column(Integer, nullable=True, comment="이미지 높이")
+    uploaded_at = Column(DateTime, default=func.now(), comment="업로드일시")
+    
+    # 관계 설정
+    project = relationship("Project", back_populates="pages")
+    layout_elements = relationship("LayoutElement", back_populates="page", cascade="all, delete-orphan")
+    
+    # 인덱스 및 제약조건
+    __table_args__ = (
+        Index("idx_project_page", "project_id", "page_number", unique=True),
+    )
+    
+    def __repr__(self):
+        return f"<Page(id={self.page_id}, project={self.project_id}, page_num={self.page_number})>"
+
+
+# ============================================================================
+# 5. Layout Elements - 레이아웃 요소
+# ============================================================================
+class LayoutElement(Base):
+    """레이아웃 요소 테이블 (DocLayout-YOLO 감지 결과)"""
+    __tablename__ = "layout_elements"
+    
+    element_id = Column(Integer, primary_key=True, autoincrement=True, comment="요소 ID")
+    page_id = Column(Integer, ForeignKey("pages.page_id", ondelete="CASCADE"), nullable=False, comment="페이지 ID")
+    element_type = Column(
+        Enum('text', 'title', 'figure', 'figure_caption', 'table', 'table_caption', 
+             'header', 'footer', 'reference', 'equation', name='element_type_enum'),
+        nullable=False,
+        comment="요소 유형"
+    )
+    x_min = Column(Integer, nullable=False, comment="좌측 상단 X 좌표")
+    y_min = Column(Integer, nullable=False, comment="좌측 상단 Y 좌표")
+    x_max = Column(Integer, nullable=False, comment="우측 하단 X 좌표")
+    y_max = Column(Integer, nullable=False, comment="우측 하단 Y 좌표")
+    confidence = Column(DECIMAL(5, 4), nullable=True, comment="신뢰도")
+    area = Column(Integer, nullable=True, comment="영역 크기 (자동 계산)")
+    x_position = Column(Integer, nullable=True, comment="X 중심 좌표 (자동 계산)")
+    y_position = Column(Integer, nullable=True, comment="Y 중심 좌표 (자동 계산)")
+    
+    # 관계 설정
+    page = relationship("Page", back_populates="layout_elements")
+    text_content = relationship("TextContent", back_populates="layout_element", uselist=False, cascade="all, delete-orphan")
+    ai_description = relationship("AIDescription", back_populates="layout_element", uselist=False, cascade="all, delete-orphan")
+    question_elements = relationship("QuestionElement", back_populates="layout_element", cascade="all, delete-orphan")
+    
+    # 인덱스
+    __table_args__ = (
+        Index("idx_page_element", "page_id", "element_id"),
+    )
+    
+    def __repr__(self):
+        return f"<LayoutElement(id={self.element_id}, type='{self.element_type}')>"
+
+
+# ============================================================================
+# 6. Text Contents - 텍스트 내용
+# ============================================================================
+class TextContent(Base):
+    """텍스트 내용 테이블 (OCR 결과)"""
+    __tablename__ = "text_contents"
+    
+    content_id = Column(Integer, primary_key=True, autoincrement=True, comment="내용 ID")
+    element_id = Column(Integer, ForeignKey("layout_elements.element_id", ondelete="CASCADE"), unique=True, nullable=False, comment="요소 ID")
+    raw_text = Column(Text, nullable=True, comment="원본 OCR 텍스트")
+    edited_text = Column(Text, nullable=True, comment="편집된 텍스트")
+    version = Column(Integer, default=1, comment="버전 번호")
+    last_edited_at = Column(DateTime, nullable=True, comment="마지막 편집일시")
+    
+    # 관계 설정
+    layout_element = relationship("LayoutElement", back_populates="text_content")
+    text_versions = relationship("TextVersion", back_populates="text_content", cascade="all, delete-orphan")
+    
+    def __repr__(self):
+        return f"<TextContent(id={self.content_id}, element={self.element_id}, v={self.version})>"
+
+
+# ============================================================================
+# 7. AI Descriptions - AI 생성 설명
+# ============================================================================
+class AIDescription(Base):
+    """AI 생성 설명 테이블 (figure/table 설명)"""
+    __tablename__ = "ai_descriptions"
+    
+    description_id = Column(Integer, primary_key=True, autoincrement=True, comment="설명 ID")
+    element_id = Column(Integer, ForeignKey("layout_elements.element_id", ondelete="CASCADE"), unique=True, nullable=False, comment="요소 ID")
+    description_text = Column(Text, nullable=True, comment="AI 생성 설명")
+    model_name = Column(String(100), nullable=True, comment="사용된 AI 모델명")
+    generated_at = Column(DateTime, default=func.now(), comment="생성일시")
+    
+    # 관계 설정
+    layout_element = relationship("LayoutElement", back_populates="ai_description")
+    
+    def __repr__(self):
+        return f"<AIDescription(id={self.description_id}, element={self.element_id})>"
+
+
+# ============================================================================
+# 8. Question Groups - 문제 그룹
+# ============================================================================
+class QuestionGroup(Base):
+    """문제 그룹 테이블 (worksheet 전용)"""
+    __tablename__ = "question_groups"
+    
+    group_id = Column(Integer, primary_key=True, autoincrement=True, comment="그룹 ID")
+    group_number = Column(Integer, nullable=False, comment="문제 번호")
+    page_id = Column(Integer, ForeignKey("pages.page_id", ondelete="CASCADE"), nullable=False, comment="페이지 ID")
+    
+    # 관계 설정
+    question_elements = relationship("QuestionElement", back_populates="question_group", cascade="all, delete-orphan")
+    
+    # 인덱스 및 제약조건
+    __table_args__ = (
+        Index("idx_page_group", "page_id", "group_number", unique=True),
+    )
+    
+    def __repr__(self):
+        return f"<QuestionGroup(id={self.group_id}, num={self.group_number})>"
+
+
+# ============================================================================
+# 9. Question Elements - 문제 요소
+# ============================================================================
+class QuestionElement(Base):
+    """문제 요소 테이블 (worksheet 전용)"""
+    __tablename__ = "question_elements"
+    
+    question_element_id = Column(Integer, primary_key=True, autoincrement=True, comment="문제 요소 ID")
+    group_id = Column(Integer, ForeignKey("question_groups.group_id", ondelete="CASCADE"), nullable=False, comment="그룹 ID")
+    element_id = Column(Integer, ForeignKey("layout_elements.element_id", ondelete="CASCADE"), nullable=False, comment="요소 ID")
+    element_order = Column(Integer, nullable=False, comment="요소 순서")
+    
+    # 관계 설정
+    question_group = relationship("QuestionGroup", back_populates="question_elements")
+    layout_element = relationship("LayoutElement", back_populates="question_elements")
+    
+    # 인덱스 및 제약조건
+    __table_args__ = (
+        Index("idx_group_order", "group_id", "element_order"),
+        Index("idx_element_unique", "element_id", unique=True),
+    )
+    
+    def __repr__(self):
+        return f"<QuestionElement(id={self.question_element_id}, group={self.group_id})>"
+
+
+# ============================================================================
+# 10. Text Versions - 텍스트 버전 관리
+# ============================================================================
+class TextVersion(Base):
+    """텍스트 버전 관리 테이블"""
+    __tablename__ = "text_versions"
+    
+    version_id = Column(Integer, primary_key=True, autoincrement=True, comment="버전 ID")
+    content_id = Column(Integer, ForeignKey("text_contents.content_id", ondelete="CASCADE"), nullable=False, comment="내용 ID")
+    version_number = Column(Integer, nullable=False, comment="버전 번호")
+    version_text = Column(Text, nullable=False, comment="버전 텍스트")
+    edited_at = Column(DateTime, default=func.now(), comment="편집일시")
+    
+    # 관계 설정
+    text_content = relationship("TextContent", back_populates="text_versions")
+    
+    # 인덱스 및 제약조건
+    __table_args__ = (
+        Index("idx_content_version", "content_id", "version_number", unique=True),
+    )
+    
+    def __repr__(self):
+        return f"<TextVersion(id={self.version_id}, content={self.content_id}, v={self.version_number})>"
+
+
+# ============================================================================
+# 11. Formatting Rules - 서식 규칙
+# ============================================================================
+class FormattingRule(Base):
+    """서식 규칙 테이블"""
+    __tablename__ = "formatting_rules"
+    
+    rule_id = Column(Integer, primary_key=True, autoincrement=True, comment="규칙 ID")
+    element_type = Column(
+        Enum('text', 'title', 'figure', 'figure_caption', 'table', 'table_caption', 
+             'header', 'footer', 'reference', 'equation', name='element_type_enum'),
+        nullable=False,
+        comment="요소 유형"
+    )
+    font_name = Column(String(100), nullable=True, comment="폰트명")
+    font_size = Column(Integer, nullable=True, comment="폰트 크기")
+    font_bold = Column(Boolean, default=False, comment="굵게")
+    font_italic = Column(Boolean, default=False, comment="기울임")
+    font_underline = Column(Boolean, default=False, comment="밑줄")
+    alignment = Column(
+        Enum('left', 'center', 'right', 'justify', name='alignment_enum'),
+        default='left',
+        comment="정렬"
+    )
+    line_spacing = Column(DECIMAL(3, 1), nullable=True, comment="줄 간격")
+    space_before = Column(Integer, nullable=True, comment="앞 여백 (pt)")
+    space_after = Column(Integer, nullable=True, comment="뒤 여백 (pt)")
+    
+    # 인덱스
+    __table_args__ = (
+        Index("idx_element_type", "element_type", unique=True),
+    )
+    
+    def __repr__(self):
+        return f"<FormattingRule(id={self.rule_id}, type='{self.element_type}')>"
+
+
+# ============================================================================
+# 12. Combined Results - 통합 결과
+# ============================================================================
+class CombinedResult(Base):
+    """통합 결과 테이블 (최종 문서 생성용)"""
+    __tablename__ = "combined_results"
+    
+    result_id = Column(Integer, primary_key=True, autoincrement=True, comment="결과 ID")
+    project_id = Column(Integer, ForeignKey("projects.project_id", ondelete="CASCADE"), nullable=False, comment="프로젝트 ID")
+    combined_text = Column(Text, nullable=True, comment="통합 텍스트")
+    output_format = Column(
+        Enum('docx', 'pdf', 'txt', name='output_format_enum'),
+        default='docx',
+        comment="출력 형식"
+    )
+    file_path = Column(String(512), nullable=True, comment="파일 경로")
+    generated_at = Column(DateTime, default=func.now(), comment="생성일시")
+    
+    # 인덱스
+    __table_args__ = (
+        Index("idx_project_generated", "project_id", "generated_at"),
+    )
+    
+    def __repr__(self):
+        return f"<CombinedResult(id={self.result_id}, project={self.project_id})>"
+
+
+# ============================================================================
+# 모델 초기화 순서 (참고용)
+# ============================================================================
+"""
+외래 키 의존성 순서:
+1. User (독립)
+2. DocumentType (독립)
+3. FormattingRule (독립)
+4. Project (User, DocumentType 의존)
+5. Page (Project 의존)
+6. LayoutElement (Page 의존)
+7. TextContent (LayoutElement 의존)
+8. AIDescription (LayoutElement 의존)
+9. QuestionGroup (Page 의존)
+10. QuestionElement (QuestionGroup, LayoutElement 의존)
+11. TextVersion (TextContent 의존)
+12. CombinedResult (Project 의존)
+"""

app/routers/__init__.py

@@ -0,0 +1,17 @@
+"""
+SmartEyeSsen Backend - Routers Package
+=======================================
+API 라우터 패키지 초기화
+
+Phase 2에서 개별 라우터 모듈이 추가될 예정:
+- users.py: 사용자 관리 API
+- projects.py: 프로젝트 관리 API
+- pages.py: 페이지 관리 API
+- layout_elements.py: 레이아웃 요소 API
+- text_contents.py: 텍스트 내용 API
+- ai_descriptions.py: AI 설명 API
+- formatting_rules.py: 서식 규칙 API
+- combined_results.py: 통합 결과 API
+"""
+
+__version__ = "1.0.0"

app/schemas.py

@@ -0,0 +1,457 @@
+"""
+SmartEyeSsen Backend - Pydantic Schemas
+=======================================
+API 요청/응답 검증을 위한 Pydantic 스키마 정의
+
+주요 기능:
+- 요청 본문 검증 (Create, Update)
+- 응답 데이터 직렬화 (Read)
+- 타입 힌팅 및 자동 문서화
+"""
+
+from pydantic import BaseModel, EmailStr, Field, ConfigDict
+from typing import Optional, List
+from datetime import datetime
+from enum import Enum
+
+
+# ============================================================================
+# Enum 정의
+# ============================================================================
+class DocumentTypeEnum(str, Enum):
+    """문서 유형"""
+    WORKSHEET = "worksheet"
+    DOCUMENT = "document"
+
+
+class ElementTypeEnum(str, Enum):
+    """레이아웃 요소 유형"""
+    TEXT = "text"
+    TITLE = "title"
+    FIGURE = "figure"
+    FIGURE_CAPTION = "figure_caption"
+    TABLE = "table"
+    TABLE_CAPTION = "table_caption"
+    HEADER = "header"
+    FOOTER = "footer"
+    REFERENCE = "reference"
+    EQUATION = "equation"
+
+
+class AlignmentEnum(str, Enum):
+    """텍스트 정렬"""
+    LEFT = "left"
+    CENTER = "center"
+    RIGHT = "right"
+    JUSTIFY = "justify"
+
+
+class OutputFormatEnum(str, Enum):
+    """출력 형식"""
+    DOCX = "docx"
+    PDF = "pdf"
+    TXT = "txt"
+
+
+# ============================================================================
+# 1. User Schemas
+# ============================================================================
+class UserBase(BaseModel):
+    """사용자 기본 스키마"""
+    username: str = Field(..., min_length=3, max_length=50, description="사용자명")
+    email: EmailStr = Field(..., description="이메일")
+
+
+class UserCreate(UserBase):
+    """사용자 생성 스키마"""
+    password: str = Field(..., min_length=8, max_length=100, description="비밀번호")
+
+
+class UserUpdate(BaseModel):
+    """사용자 수정 스키마"""
+    username: Optional[str] = Field(None, min_length=3, max_length=50)
+    email: Optional[EmailStr] = None
+    password: Optional[str] = Field(None, min_length=8, max_length=100)
+
+
+class UserResponse(UserBase):
+    """사용자 응답 스키마"""
+    user_id: int
+    created_at: datetime
+    last_login: Optional[datetime] = None
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 2. DocumentType Schemas
+# ============================================================================
+class DocumentTypeBase(BaseModel):
+    """문서 유형 기본 스키마"""
+    type_name: DocumentTypeEnum = Field(..., description="문서 유형")
+    description: Optional[str] = Field(None, max_length=255, description="유형 설명")
+
+
+class DocumentTypeCreate(DocumentTypeBase):
+    """문서 유형 생성 스키마"""
+    pass
+
+
+class DocumentTypeResponse(DocumentTypeBase):
+    """문서 유형 응답 스키마"""
+    type_id: int
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 3. Project Schemas
+# ============================================================================
+class ProjectBase(BaseModel):
+    """프로젝트 기본 스키마"""
+    project_name: str = Field(..., min_length=1, max_length=255, description="프로젝트명")
+    type_id: Optional[int] = Field(None, description="문서 유형 ID")
+
+
+class ProjectCreate(ProjectBase):
+    """프로젝트 생성 스키마"""
+    pass
+
+
+class ProjectUpdate(BaseModel):
+    """프로젝트 수정 스키마"""
+    project_name: Optional[str] = Field(None, min_length=1, max_length=255)
+    type_id: Optional[int] = None
+
+
+class ProjectResponse(ProjectBase):
+    """프로젝트 응답 스키마"""
+    project_id: int
+    user_id: int
+    created_at: datetime
+    updated_at: datetime
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+class ProjectWithPagesResponse(ProjectResponse):
+    """페이지 포함 프로젝트 응답"""
+    pages: List["PageResponse"] = []
+
+
+# ============================================================================
+# 4. Page Schemas
+# ============================================================================
+class PageBase(BaseModel):
+    """페이지 기본 스키마"""
+    page_number: int = Field(..., ge=1, description="페이지 번호")
+    image_path: Optional[str] = Field(None, max_length=512, description="이미지 경로")
+    image_width: Optional[int] = Field(None, ge=1, description="이미지 너비")
+    image_height: Optional[int] = Field(None, ge=1, description="이미지 높이")
+
+
+class PageCreate(PageBase):
+    """페이지 생성 스키마"""
+    project_id: int = Field(..., description="프로젝트 ID")
+
+
+class PageUpdate(BaseModel):
+    """페이지 수정 스키마"""
+    image_path: Optional[str] = Field(None, max_length=512)
+    image_width: Optional[int] = Field(None, ge=1)
+    image_height: Optional[int] = Field(None, ge=1)
+
+
+class PageResponse(PageBase):
+    """페이지 응답 스키마"""
+    page_id: int
+    project_id: int
+    uploaded_at: datetime
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+class PageWithElementsResponse(PageResponse):
+    """레이아웃 요소 포함 페이지 응답"""
+    layout_elements: List["LayoutElementResponse"] = []
+
+
+# ============================================================================
+# 5. LayoutElement Schemas
+# ============================================================================
+class LayoutElementBase(BaseModel):
+    """레이아웃 요소 기본 스키마"""
+    element_type: ElementTypeEnum = Field(..., description="요소 유형")
+    x_min: int = Field(..., description="좌측 상단 X 좌표")
+    y_min: int = Field(..., description="좌측 상단 Y 좌표")
+    x_max: int = Field(..., description="우측 하단 X 좌표")
+    y_max: int = Field(..., description="우측 하단 Y 좌표")
+    confidence: Optional[float] = Field(None, ge=0.0, le=1.0, description="신뢰도")
+
+
+class LayoutElementCreate(LayoutElementBase):
+    """레이아웃 요소 생성 스키마"""
+    page_id: int = Field(..., description="페이지 ID")
+
+
+class LayoutElementUpdate(BaseModel):
+    """레이아웃 요소 수정 스키마"""
+    element_type: Optional[ElementTypeEnum] = None
+    x_min: Optional[int] = None
+    y_min: Optional[int] = None
+    x_max: Optional[int] = None
+    y_max: Optional[int] = None
+    confidence: Optional[float] = Field(None, ge=0.0, le=1.0)
+
+
+class LayoutElementResponse(LayoutElementBase):
+    """레이아웃 요소 응답 스키마"""
+    element_id: int
+    page_id: int
+    area: Optional[int] = None
+    x_position: Optional[int] = None
+    y_position: Optional[int] = None
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 6. TextContent Schemas
+# ============================================================================
+class TextContentBase(BaseModel):
+    """텍스트 내용 기본 스키마"""
+    raw_text: Optional[str] = Field(None, description="원본 OCR 텍스트")
+    edited_text: Optional[str] = Field(None, description="편집된 텍스트")
+
+
+class TextContentCreate(TextContentBase):
+    """텍스트 내용 생성 스키마"""
+    element_id: int = Field(..., description="요소 ID")
+
+
+class TextContentUpdate(BaseModel):
+    """텍스트 내용 수정 스키마"""
+    edited_text: Optional[str] = Field(None, description="편집된 텍스트")
+
+
+class TextContentResponse(TextContentBase):
+    """텍스트 내용 응답 스키마"""
+    content_id: int
+    element_id: int
+    version: int
+    last_edited_at: Optional[datetime] = None
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 7. AIDescription Schemas
+# ============================================================================
+class AIDescriptionBase(BaseModel):
+    """AI 설명 기본 스키마"""
+    description_text: Optional[str] = Field(None, description="AI 생성 설명")
+    model_name: Optional[str] = Field(None, max_length=100, description="AI 모델명")
+
+
+class AIDescriptionCreate(AIDescriptionBase):
+    """AI 설명 생성 스키마"""
+    element_id: int = Field(..., description="요소 ID")
+
+
+class AIDescriptionResponse(AIDescriptionBase):
+    """AI 설명 응답 스키마"""
+    description_id: int
+    element_id: int
+    generated_at: datetime
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 8. QuestionGroup Schemas
+# ============================================================================
+class QuestionGroupBase(BaseModel):
+    """문제 그룹 기본 스키마"""
+    group_number: int = Field(..., ge=1, description="문제 번호")
+    page_id: int = Field(..., description="페이지 ID")
+
+
+class QuestionGroupCreate(QuestionGroupBase):
+    """문제 그룹 생성 스키마"""
+    pass
+
+
+class QuestionGroupResponse(QuestionGroupBase):
+    """문제 그룹 응답 스키마"""
+    group_id: int
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 9. QuestionElement Schemas
+# ============================================================================
+class QuestionElementBase(BaseModel):
+    """문제 요소 기본 스키마"""
+    group_id: int = Field(..., description="그룹 ID")
+    element_id: int = Field(..., description="요소 ID")
+    element_order: int = Field(..., ge=1, description="요소 순서")
+
+
+class QuestionElementCreate(QuestionElementBase):
+    """문제 요소 생성 스키마"""
+    pass
+
+
+class QuestionElementResponse(QuestionElementBase):
+    """문제 요소 응답 스키마"""
+    question_element_id: int
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 10. TextVersion Schemas
+# ============================================================================
+class TextVersionBase(BaseModel):
+    """텍스트 버전 기본 스키마"""
+    version_number: int = Field(..., ge=1, description="버전 번호")
+    version_text: str = Field(..., description="버전 텍스트")
+
+
+class TextVersionCreate(TextVersionBase):
+    """텍스트 버전 생성 스키마"""
+    content_id: int = Field(..., description="내용 ID")
+
+
+class TextVersionResponse(TextVersionBase):
+    """텍스트 버전 응답 스키마"""
+    version_id: int
+    content_id: int
+    edited_at: datetime
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 11. FormattingRule Schemas
+# ============================================================================
+class FormattingRuleBase(BaseModel):
+    """서식 규칙 기본 스키마"""
+    element_type: ElementTypeEnum = Field(..., description="요소 유형")
+    font_name: Optional[str] = Field(None, max_length=100, description="폰트명")
+    font_size: Optional[int] = Field(None, ge=1, le=72, description="폰트 크기")
+    font_bold: bool = Field(False, description="굵게")
+    font_italic: bool = Field(False, description="기울임")
+    font_underline: bool = Field(False, description="밑줄")
+    alignment: AlignmentEnum = Field(AlignmentEnum.LEFT, description="정렬")
+    line_spacing: Optional[float] = Field(None, ge=0.5, le=3.0, description="줄 간격")
+    space_before: Optional[int] = Field(None, ge=0, description="앞 여백 (pt)")
+    space_after: Optional[int] = Field(None, ge=0, description="뒤 여백 (pt)")
+
+
+class FormattingRuleCreate(FormattingRuleBase):
+    """서식 규칙 생성 스키마"""
+    pass
+
+
+class FormattingRuleUpdate(BaseModel):
+    """서식 규칙 수정 스키마"""
+    font_name: Optional[str] = Field(None, max_length=100)
+    font_size: Optional[int] = Field(None, ge=1, le=72)
+    font_bold: Optional[bool] = None
+    font_italic: Optional[bool] = None
+    font_underline: Optional[bool] = None
+    alignment: Optional[AlignmentEnum] = None
+    line_spacing: Optional[float] = Field(None, ge=0.5, le=3.0)
+    space_before: Optional[int] = Field(None, ge=0)
+    space_after: Optional[int] = Field(None, ge=0)
+
+
+class FormattingRuleResponse(FormattingRuleBase):
+    """서식 규칙 응답 스키마"""
+    rule_id: int
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 12. CombinedResult Schemas
+# ============================================================================
+class CombinedResultBase(BaseModel):
+    """통합 결과 기본 스키마"""
+    combined_text: Optional[str] = Field(None, description="통합 텍스트")
+    output_format: OutputFormatEnum = Field(OutputFormatEnum.DOCX, description="출력 형식")
+    file_path: Optional[str] = Field(None, max_length=512, description="파일 경로")
+
+
+class CombinedResultCreate(CombinedResultBase):
+    """통합 결과 생성 스키마"""
+    project_id: int = Field(..., description="프로젝트 ID")
+
+
+class CombinedResultResponse(CombinedResultBase):
+    """통합 결과 응답 스키마"""
+    result_id: int
+    project_id: int
+    generated_at: datetime
+    
+    model_config = ConfigDict(from_attributes=True)
+
+
+# ============================================================================
+# 복합 응답 스키마 (관계 포함)
+# ============================================================================
+class LayoutElementWithContentResponse(LayoutElementResponse):
+    """텍스트 및 AI 설명 포함 레이아웃 요소"""
+    text_content: Optional[TextContentResponse] = None
+    ai_description: Optional[AIDescriptionResponse] = None
+
+
+class PageDetailResponse(PageResponse):
+    """상세 페이지 정보 (모든 관계 포함)"""
+    layout_elements: List[LayoutElementWithContentResponse] = []
+
+
+class ProjectDetailResponse(ProjectResponse):
+    """상세 프로젝트 정보 (페이지 및 결과 포함)"""
+    pages: List[PageDetailResponse] = []
+    combined_results: List[CombinedResultResponse] = []
+    document_type: Optional[DocumentTypeResponse] = None
+
+
+# ============================================================================
+# 유틸리티 스키마
+# ============================================================================
+class MessageResponse(BaseModel):
+    """일반 메시지 응답"""
+    message: str
+    detail: Optional[str] = None
+
+
+class ErrorResponse(BaseModel):
+    """에러 응답"""
+    error: str
+    detail: Optional[str] = None
+    status_code: int
+
+
+class PaginationParams(BaseModel):
+    """페이지네이션 파라미터"""
+    skip: int = Field(0, ge=0, description="건너뛸 개수")
+    limit: int = Field(100, ge=1, le=1000, description="조회 개수")
+
+
+class PaginatedResponse(BaseModel):
+    """페이지네이션 응답"""
+    total: int = Field(..., description="전체 개수")
+    skip: int = Field(..., description="건너뛴 개수")
+    limit: int = Field(..., description="조회 개수")
+    items: List = Field(..., description="데이터 목록")
+
+
+# ============================================================================
+# Forward Reference 해결
+# ============================================================================
+ProjectWithPagesResponse.model_rebuild()
+PageWithElementsResponse.model_rebuild()

requirements.txt

@@ -0,0 +1,69 @@
+# ============================================================================
+# SmartEyeSsen Backend - Python Dependencies
+# ============================================================================
+# FastAPI 프레임워크 및 웹 서버
+# ============================================================================
+fastapi==0.109.0
+uvicorn[standard]==0.27.0
+python-multipart==0.0.6
+
+# ============================================================================
+# 데이터베이스 및 ORM
+# ============================================================================
+sqlalchemy==2.0.25
+pymysql==1.1.0
+cryptography==42.0.0  # pymysql 암호화 지원
+alembic==1.13.1  # 데이터베이스 마이그레이션 도구
+
+# ============================================================================
+# 데이터 검증 및 설정
+# ============================================================================
+pydantic==2.5.3
+pydantic-settings==2.1.0
+python-dotenv==1.0.0
+
+# ============================================================================
+# AI/ML 라이브러리
+# ============================================================================
+# DocLayout-YOLO 및 OCR
+ultralytics==8.1.0
+paddlepaddle==2.6.0
+paddleocr==2.7.0
+# OpenAI API (AI 설명 생성)
+openai==1.10.0
+
+# ============================================================================
+# 이미지 처리
+# ============================================================================
+pillow==10.2.0
+opencv-python==4.9.0.80
+
+# ============================================================================
+# 문서 생성
+# ============================================================================
+python-docx==1.1.0
+
+# ============================================================================
+# 유틸리티
+# ============================================================================
+# 날짜/시간 처리
+python-dateutil==2.8.2
+# HTTP 클라이언트
+httpx==0.26.0
+# 로깅
+loguru==0.7.2
+
+# ============================================================================
+# 보안 (선택사항)
+# ============================================================================
+# JWT 토큰 인증
+python-jose[cryptography]==3.3.0
+passlib[bcrypt]==1.7.4
+
+# ============================================================================
+# 개발 도구 (선택사항)
+# ============================================================================
+# pytest==7.4.4
+# pytest-asyncio==0.23.3
+# black==23.12.1
+# flake8==7.0.0

start_server.bat

@@ -0,0 +1,48 @@
+@echo off
+REM ============================================================================
+REM SmartEyeSsen Backend - 서버 시작 스크립트 (Windows)
+REM ============================================================================
+
+echo ============================================================
+echo SmartEyeSsen Backend Server
+echo ============================================================
+echo.
+
+REM 가상환경 확인
+if exist "venv\Scripts\activate.bat" (
+    echo [1/3] Activating virtual environment...
+    call venv\Scripts\activate.bat
+) else (
+    echo [WARNING] Virtual environment not found!
+    echo Please create one with: python -m venv venv
+    echo.
+)
+
+REM 환경 변수 파일 확인
+if not exist ".env" (
+    echo [WARNING] .env file not found!
+    echo Please copy .env.example to .env and configure it.
+    echo.
+    pause
+    exit /b 1
+)
+
+echo [2/3] Checking dependencies...
+pip list | findstr "fastapi" >nul
+if errorlevel 1 (
+    echo [INFO] Installing dependencies...
+    pip install -r requirements.txt
+)
+
+echo [3/3] Starting FastAPI server...
+echo.
+echo ============================================================
+echo Server will start at: http://localhost:8000
+echo API Documentation: http://localhost:8000/docs
+echo ============================================================
+echo.
+
+REM FastAPI 서버 실행
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+
+pause