# 로컬 MariaDB 실행 가이드

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

## 1. DB 컨테이너 실행
프로젝트 루트에서 아래 명령으로 실행한다.

```bash
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 기준 환경변수를 포함한다.

```bash
cd backend
npm run dev
```

## 4. 프런트엔드 실행
```bash
cd frontend
VITE_API_ORIGIN=http://localhost:5179 npm run dev
```

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