tier-maker/docs/local-mariadb.md

로컬 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. 백엔드 실행

아래 명령은 로컬 MariaDB 기준 환경변수를 포함한다.

cd backend
npm run dev

4. 프런트엔드 실행

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

5. 기존 lowdb 데이터 이관

MariaDB 컨테이너와 백엔드 의존성이 준비된 뒤 아래 명령을 실행한다.

cd backend
npm run migrate:lowdb

메모

• 긴급 확인용으로만 npm run dev:lowdb를 남겨두었고, 기본 개발 기준은 MariaDB다.
• NAS 배포 시에도 동일하게 MariaDB를 사용하므로 로컬과 운영 간 DB 계층 차이를 줄일 수 있다.