05843da1c4
- Replaced SELECT* queries in 8 models with explicit columns. - Began modularizing work-report-calendar.js by creating CalendarAPI.js, CalendarState.js, and CalendarView.js. - Refactored manage-project.js to use global API helpers. - Fixed API container crash by adding missing volume mounts to docker-compose.yml. - Added new migration for missing columns in the projects table. - Documented current DB schema and deployment notes.
86 lines
2.2 KiB
Markdown
86 lines
2.2 KiB
Markdown
# TK-FB-Project - 통합 실행 가이드
|
|
|
|
## ⚙️ 사전 준비
|
|
|
|
### 환경 변수 설정 (필수)
|
|
처음 실행하기 전에 환경 변수 파일을 생성해야 합니다:
|
|
|
|
```bash
|
|
# 1. .env.example을 복사하여 .env 파일 생성
|
|
cp .env.example .env
|
|
|
|
# 2. .env 파일을 편집하여 실제 비밀번호로 변경
|
|
nano .env # 또는 vi, code 등 사용
|
|
|
|
# 3. 강력한 비밀번호로 변경 (예시)
|
|
# MYSQL_ROOT_PASSWORD=your_secure_password_here
|
|
# MYSQL_PASSWORD=your_secure_password_here
|
|
# JWT_SECRET=your_random_jwt_secret_min_32_chars
|
|
```
|
|
|
|
**중요**: `.env` 파일은 절대 Git에 커밋하지 마세요!
|
|
|
|
## 🚀 한 번에 모든 서비스 실행
|
|
|
|
### 🎯 간편 실행 (권장)
|
|
```bash
|
|
cd /Users/hyungi/docker/TK-FB-Project
|
|
./start.sh
|
|
```
|
|
|
|
### 🛑 간편 중지
|
|
```bash
|
|
./stop.sh
|
|
```
|
|
|
|
### 📋 직접 실행
|
|
```bash
|
|
docker-compose up -d
|
|
docker-compose down
|
|
```
|
|
|
|
## 📊 서비스 목록
|
|
|
|
| 서비스 | 포트 | 접속 URL | 설명 |
|
|
|--------|------|----------|------|
|
|
| **웹 UI** | 20000 | http://localhost:20000 | 메인 웹 인터페이스 |
|
|
| **API 서버** | 20005 | http://localhost:20005 | Node.js API 서버 ✅ |
|
|
| **FastAPI 브릿지** | 20010 | http://localhost:20010 | Python FastAPI 서비스 |
|
|
| **phpMyAdmin** | 20080 | http://localhost:20080 | DB 관리도구 |
|
|
| **MariaDB** | 20306 | - | 데이터베이스 서버 |
|
|
|
|
## 🛠️ 관리 명령어
|
|
|
|
### 모든 서비스 중지
|
|
```bash
|
|
cd /Users/hyungi/docker/TK-FB-Project
|
|
docker-compose down
|
|
```
|
|
|
|
### 서비스 상태 확인
|
|
```bash
|
|
docker ps | grep fb_
|
|
```
|
|
|
|
### 로그 확인
|
|
```bash
|
|
docker-compose logs -f
|
|
```
|
|
|
|
## 💾 데이터베이스 정보
|
|
|
|
- **호스트**: localhost:20306
|
|
- **데이터베이스**: hyungi (`.env` 파일의 `MYSQL_DATABASE`)
|
|
- **사용자**: hyungi_user (`.env` 파일의 `MYSQL_USER`)
|
|
- **비밀번호**: `.env` 파일에서 설정한 `MYSQL_PASSWORD`
|
|
- **Root 비밀번호**: `.env` 파일에서 설정한 `MYSQL_ROOT_PASSWORD`
|
|
|
|
**참고**: 실제 비밀번호는 `.env` 파일을 확인하세요.
|
|
|
|
## ✨ 주요 개선사항
|
|
|
|
1. **통합 실행**: 한 번의 명령으로 모든 서비스 실행
|
|
2. **깔끔한 DB 초기화**: 마이그레이션 오류 해결
|
|
3. **일관된 네이밍**: fb_ 접두사로 컨테이너 구분
|
|
4. **안정적인 포트**: 20000번대 포트 사용
|