릴리스: v0.1.6 MariaDB 개발 환경 및 저장소 설정 정리

docs/local-mariadb.md

@@ -0,0 +1,46 @@
+# 로컬 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
+```
+
+## 5. 기존 lowdb 데이터 이관
+MariaDB 컨테이너와 백엔드 의존성이 준비된 뒤 아래 명령을 실행한다.
+
+```bash
+cd backend
+npm run migrate:lowdb
+```
+
+## 메모
+- 긴급 확인용으로만 `npm run dev:lowdb`를 남겨두었고, 기본 개발 기준은 MariaDB다.
+- NAS 배포 시에도 동일하게 MariaDB를 사용하므로 로컬과 운영 간 DB 계층 차이를 줄일 수 있다.