feat: 모델 및 데이터베이스 구조 개선

- 모델 파일들의 데이터베이스 연결 및 쿼리 최적화
- 마이그레이션 파일 정리 및 통합
- Docker 설정 파일 추가
- 프로젝트 시작/중지 스크립트 추가
- README 및 문서 업데이트
This commit is contained in:
hyungi
2025-10-27 10:01:12 +09:00
parent f96604b01e
commit 5ff0c7cd60
19 changed files with 13972 additions and 33 deletions

63
README.md Normal file
View File

@@ -0,0 +1,63 @@
# TK-FB-Project - 통합 실행 가이드
## 🚀 한 번에 모든 서비스 실행
### 🎯 간편 실행 (권장)
```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
- **사용자**: hyungi
- **비밀번호**: hyungi_password_2025
- **Root 비밀번호**: hyungi_root_password_2025
## ✨ 주요 개선사항
1. **통합 실행**: 한 번의 명령으로 모든 서비스 실행
2. **깔끔한 DB 초기화**: 마이그레이션 오류 해결
3. **일관된 네이밍**: fb_ 접두사로 컨테이너 구분
4. **안정적인 포트**: 20000번대 포트 사용