• 목차
• 🟥 Epic 1 — Task (DB Init)
  • 🗄️ PostgreSQL 초기화 + User 테이블 생성
    • 📌 작업 개요
      • 🛠️ 1. User 모델 생성
      • 🛠️ 2. DB 초기화 스크립트 생성
      • 🛠️ 3. DB 연결 테스트 API
      • 🧪 4. 로그인 테스트 흐름

🟥 Epic 1 — Task (DB Init)¶

🗄️ PostgreSQL 초기화 + User 테이블 생성¶

📌 작업 개요¶

FastAPI 로그인 기능을 실제로 동작시키기 위해

PostgreSQL에 user 테이블을 생성하고,

초기 관리자 계정을 등록할 수 있는 DB 초기화 스크립트(.sh)를 만든다.

이 스크립트는 mgmt 서버 배포 시

• DB 테이블 자동 생성

• 초기 admin 계정 자동 생성을 담당하는 핵심 운영 도구가 된다.

🛠️ 1. User 모델 생성¶

📁 app/models/user.py

from sqlalchemy import Column, String, DateTime
from datetime import datetime
from app.db import Base

class User(Base):
    __tablename__ = "user"

    username = Column(String(50), primary_key=True)
    password_hash = Column(String(200))
    nickname = Column(String(100))
    expire = Column(DateTime, nullable=True)
    last_login_time = Column(DateTime, nullable=True)
    last_login_ip = Column(String(50), nullable=True)

📌 설계 포인트

• username PK

• password_hash SHA256 또는 bcrypt

• expire → 계정 만료일

• last_login_time / last_login_ip → 보안 로그용

🛠️ 2. DB 초기화 스크립트 생성¶

📁 scripts/db_init.sh

아래 스크립트는

• 모든 SQLAlchemy 모델 테이블 생성

• admin 계정 자동 생성까지 포함한다.

#!/bin/bash

echo "🔧 PostgreSQL DB 초기화 시작..."

# Python으로 테이블 생성
python3 - << 'EOF'
from app.db import Base, engine, SessionLocal
from app.models.user import User
from app.models.server_master import ServerMaster
from app.models.server_status import ServerStatus
from app.models.server_control import ServerControl
from app.models.server_detail import ServerDetail
from app.core.security import hash_password

# 테이블 생성
Base.metadata.create_all(bind=engine)

# 초기 admin 계정 생성
db = SessionLocal()

admin = db.query(User).filter(User.username == "admin").first()
if not admin:
    admin = User(
        username="admin",
        password_hash=hash_password("1234"),
        nickname="관리자",
        expire=None,
        last_login_time=None,
        last_login_ip=None
    )
    db.add(admin)
    db.commit()
    print("✅ admin 계정 생성 완료 (username=admin, password=1234)")
else:
    print("ℹ️ admin 계정 이미 존재함")

db.close()
EOF

echo "🎉 DB 초기화 완료!"

📌 실행 방법

chmod +x scripts/db_init.sh
./scripts/db_init.sh

🛠️ 3. DB 연결 테스트 API¶

📁 app/routers/auth.py 또는 health.py

@router.get("/db-check")
def db_check(db: Session = Depends(get_db)):
    return {"status": "ok"}

🧪 4. 로그인 테스트 흐름¶

1)DB 초기화 실행

./scripts/db_init.sh

2. FastAPI 서버 실행

uvicorn app.main:app --reload

3. test_main.http에서 로그인 테스트

### Login Test
POST http://127.0.0.1:8000/login
Content-Type: application/json

{
  "username": "admin",
  "password": "1234"
}

4. 토큰으로 /me 테스트

GET http://127.0.0.1:8000/me
Authorization: Bearer {{token}}

📌 산출물

• user 테이블 생성

• admin 계정 자동 생성

• PostgreSQL 초기화 스크립트 완성

• 로그인 기능 실제 DB 기반으로 동작

• /me, /logout 테스트 가능