Files
tmaker.sori.studio/docs/local-mariadb.md
zenn 73d198f5a9 로컬 환경 분리와 회원가입 중복 검증 보강
로컬 개발 환경은 .env.local을 우선 읽고 운영은 .env.production만 읽도록 분리해 인증 우회 설정이 운영에 섞이지 않게 정리했다. 회원가입/로그인 이메일 정규화와 중복 예외 처리를 보강해 대소문자·공백 변형 중복 가입을 안정적으로 차단했다.

Made-with: Cursor
2026-04-27 11:33:10 +09:00

1.1 KiB

로컬 MariaDB 실행 가이드

목표

  • 로컬 개발 환경도 서버와 같은 MariaDB(MySQL 호환) 기반으로 맞춘다.
  • 데이터 확인은 phpMyAdmin으로 직접 한다.

1. DB 컨테이너 실행

프로젝트 루트에서 아래 명령으로 실행한다.

docker compose up -d mariadb phpmyadmin

2. 접속 정보

  • MariaDB 호스트: 127.0.0.1
  • MariaDB 포트: 3307
  • DB 이름: tier_cursor
  • 계정: tier_cursor
  • 비밀번호: tier_cursor1234
  • phpMyAdmin: http://localhost:8081

3. 백엔드 실행

로컬 실행은 루트 .env.local을 기준으로 동작한다. 처음 한 번 아래처럼 복사해 둔다.

cp .env.local.example .env.local

그 다음 백엔드를 실행한다.

cd backend
npm run dev

4. 프런트엔드 실행

cd frontend
VITE_API_ORIGIN=http://localhost:5179 npm run dev

메모

  • 현재 코드베이스는 MariaDB 전용이며, 로컬과 NAS 모두 같은 DB 계층을 사용한다.
  • NAS 배포 시에도 동일하게 MariaDB를 사용하므로 로컬과 운영 간 DB 계층 차이를 줄일 수 있다.