From 05b77140d64e670f8ef0f0c3582604c9c9bd0245 Mon Sep 17 00:00:00 2001
From: caadiq <caadiq@gmail.com>
Date: Wed, 31 Dec 2025 21:46:09 +0900
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20README=20=EB=B0=8F=20.gitignore?=
 =?UTF-8?q?=20=EC=8A=A4=ED=83=80=EC=9D=BC=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .env       | 10 ++++++
 .gitignore | 32 ++++++++----------
 README.md  | 97 +++++++++++++++++++++++++++++++++++++++++++++++-------
 3 files changed, 109 insertions(+), 30 deletions(-)
 create mode 100644 .env

diff --git a/.env b/.env
new file mode 100644
index 0000000..30f9379
--- /dev/null
+++ b/.env
@@ -0,0 +1,10 @@
+# Database
+DB_HOST=mariadb
+DB_PORT=3306
+DB_USER=fromis9
+DB_PASSWORD=Xk9#mP2$vL7@nQ4w
+DB_NAME=fromis9
+
+# Server
+PORT=80
+NODE_ENV=production
diff --git a/.gitignore b/.gitignore
index d380c5e..e0755fe 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,26 +1,20 @@
 # Dependencies
 node_modules/
 
-# Build output
-dist/
-build/
-
-# Environment variables
-.env
-.env.local
-.env.*.local
-
-# IDE
-.vscode/
-.idea/
-
-# OS
-.DS_Store
-Thumbs.db
-
 # Logs
 *.log
 npm-debug.log*
 
-# Cache
-.cache/
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Build
+dist/
+build/
diff --git a/README.md b/README.md
index aad7f6b..e1084e2 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,95 @@
-# fromis_9 Fan Site
+# 🌸 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)
 
-- **Frontend**: React 18 + Vite + TailwindCSS
-- **Backend**: Express.js (Node 20)
-- **Database**: MariaDB
-- **Container**: Docker Compose
+---
 
-## 실행 방법
+## ✨ 주요 기능
 
-```bash
-docker-compose up -d --build
+- 👥 **멤버 소개** - 프로미스나인 멤버 프로필 및 상세 정보
+- 💿 **디스코그래피** - 앨범 목록 및 타이틀곡 정보
+- 📅 **스케줄** - 예정된 활동 일정 (자동 업데이트)
+- 🔗 **SNS 링크** - 공식 소셜 미디어 바로가기
+
+---
+
+## 📁 프로젝트 구조
+
+```
+fromis_9/
+├── frontend/          # React + Vite 프론트엔드
+├── backend/           # Node.js + Express 백엔드
+├── Dockerfile         # 멀티스테이지 Docker 빌드
+└── docker-compose.yml # Docker Compose 설정
 ```
 
-## 도메인
+---
 
-- https://fromis9.caadiq.co.kr
+## 🛠️ 기술 스택
+
+### 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