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

45 lines
1.1 KiB
Markdown

# 로컬 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. 백엔드 실행
로컬 실행은 루트 `.env.local`을 기준으로 동작한다. 처음 한 번 아래처럼 복사해 둔다.
```bash
cp .env.local.example .env.local
```
그 다음 백엔드를 실행한다.
```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 계층 차이를 줄일 수 있다.