fromis_9/README.md

# 🌸 fromis_9 Fan Site

프로미스나인 팬사이트입니다.

![React](https://img.shields.io/badge/React-18-61DAFB?logo=react)
![Node.js](https://img.shields.io/badge/Node.js-20-339933?logo=nodedotjs)
![Docker](https://img.shields.io/badge/Docker-2496ED?logo=docker)

---

## ✨ 주요 기능

- 👥 **멤버 소개** - 프로미스나인 멤버 프로필 및 상세 정보
- 💿 **디스코그래피** - 앨범 목록 및 타이틀곡 정보
- 📅 **스케줄** - 예정된 활동 일정 (자동 업데이트)
- 🔗 **SNS 링크** - 공식 소셜 미디어 바로가기

---

## 📁 프로젝트 구조

```
fromis_9/
├── frontend/          # React + Vite 프론트엔드
├── backend/           # Node.js + Express 백엔드
├── Dockerfile         # 멀티스테이지 Docker 빌드
└── docker-compose.yml # Docker Compose 설정
```

---

## 🛠️ 기술 스택

### Frontend

| 기술                    | 설명           |
| ----------------------- | -------------- |
| **React 18**            | UI 라이브러리  |
| **Vite**                | 빌드 도구      |
| **TailwindCSS**         | CSS 프레임워크 |
| **react-device-detect** | PC/모바일 분기 |
| **framer-motion**       | 애니메이션     |

### Backend

| 기술        | 설명              |
| ----------- | ----------------- |
| **Node.js** | 런타임 환경       |
| **Express** | 웹 프레임워크     |
| **MySQL2**  | 데이터베이스 연동 |

---

## 🚀 실행 방법

### Docker (권장)

```bash
docker compose up -d --build
```

### 개발 모드

```bash
# 프론트엔드
cd frontend && npm install && npm run dev

# 백엔드
cd backend && npm install && npm start
```

---

## ⚙️ 환경 변수

`.env` 파일에 다음 변수들을 설정하세요:

```env
DB_HOST=mariadb
DB_USER=fromis9
DB_PASSWORD=your_password
DB_NAME=fromis9
```

---

## 🌐 접속

- **URL**: https://fromis9.caadiq.co.kr

---

## 📄 라이선스

MIT License