5.1. PostgreSQL 표준

5.1.1. 필수 사용 선언

모든 TQS 인증 프로젝트의 관계형 데이터베이스는 PostgreSQL을 사용해야 합니다. MySQL, MariaDB, Oracle 등 다른 RDBMS는 허용하지 않습니다.

항목	기준
RDBMS	PostgreSQL
최소 버전	15 이상
권장 버전	16 이상 (최신 안정 버전)
문자셋	UTF-8

5.1.2. 로컬 개발 환경

로컬 개발 환경에서는 Docker Compose를 사용하여 PostgreSQL을 구성합니다.

# docker-compose.yml
version: '3.8'

services:
  postgres:
    image: postgres:16-alpine
    container_name: flowin-postgres
    environment:
      POSTGRES_DB: flowin
      POSTGRES_USER: flowin
      POSTGRES_PASSWORD: flowin1234
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

# 실행
docker compose up -d

# 접속 확인
docker compose exec postgres psql -U flowin -d flowin

주의

docker-compose.yml의 비밀번호는 로컬 개발 전용입니다. 운영 환경의 비밀번호는 반드시 환경변수 또는 시크릿 매니저로 관리합니다.