mirror of
https://github.com/nethunterzist/trendyol-analiz
synced 2026-07-01 01:17:04 +00:00
c7be57064b
- FastAPI backend with Python - React + Vite admin panel - PostgreSQL database - Trendyol marketplace analytics - GitHub Actions CI/CD workflow Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
230 lines
3.3 KiB
Markdown
230 lines
3.3 KiB
Markdown
# Kurulum Kılavuzu
|
||
|
||
Trendyol Product Dashboard localhost kurulum rehberi.
|
||
|
||
## Gereksinimler
|
||
|
||
### Yazılım
|
||
- Python 3.8+
|
||
- Node.js 18+
|
||
- npm 9+
|
||
|
||
### Donanım
|
||
- RAM: 4GB minimum (8GB önerilen)
|
||
- Disk: 2GB boş alan
|
||
- Internet bağlantısı
|
||
|
||
### Versiyon Kontrolü
|
||
|
||
```bash
|
||
python3 --version # 3.8+
|
||
node --version # v18+
|
||
npm --version # 9+
|
||
```
|
||
|
||
## Hızlı Kurulum
|
||
|
||
### 1. Dependency Kurulumu
|
||
|
||
**Backend:**
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
**Frontend:**
|
||
```bash
|
||
cd admin-panel
|
||
npm install
|
||
```
|
||
|
||
### 2. Uygulamayı Başlat
|
||
|
||
**Otomatik (Önerilen):**
|
||
```bash
|
||
python3 start.py
|
||
```
|
||
|
||
**Manuel:**
|
||
```bash
|
||
# Terminal 1
|
||
cd backend && python3 main.py
|
||
|
||
# Terminal 2
|
||
cd admin-panel && npm run dev
|
||
```
|
||
|
||
### 3. Erişim
|
||
|
||
| Servis | URL |
|
||
|--------|-----|
|
||
| Frontend | http://localhost:5173 |
|
||
| Backend API | http://127.0.0.1:8001 |
|
||
| API Docs | http://127.0.0.1:8001/docs |
|
||
|
||
## Environment Yapılandırması
|
||
|
||
### Frontend (.env)
|
||
|
||
```bash
|
||
cd admin-panel
|
||
echo "VITE_API_URL=http://127.0.0.1:8001" > .env
|
||
```
|
||
|
||
### Backend
|
||
|
||
Port ve CORS konfigürasyonu `backend/main.py` içinde hardcoded:
|
||
- Port: 8001
|
||
- CORS: localhost:5173, 5174, 5175
|
||
|
||
## Database
|
||
|
||
SQLite otomatik oluşturulur. Manuel başlatma:
|
||
|
||
```bash
|
||
cd backend
|
||
python3 -c "from database import init_db; init_db()"
|
||
```
|
||
|
||
### Database Yedekleme
|
||
|
||
```bash
|
||
cp backend/trendyol.db backend/trendyol.db.backup
|
||
```
|
||
|
||
## Sorun Giderme
|
||
|
||
### Port Çakışması
|
||
|
||
```bash
|
||
# Otomatik çözüm
|
||
python3 start.py
|
||
|
||
# Manuel çözüm
|
||
lsof -ti:8001 | xargs kill -9
|
||
lsof -ti:5173 | xargs kill -9
|
||
```
|
||
|
||
### "Failed to fetch" Hatası
|
||
|
||
1. Backend'in çalıştığını kontrol et:
|
||
```bash
|
||
curl http://127.0.0.1:8001/
|
||
```
|
||
|
||
2. `.env` dosyasını kontrol et:
|
||
```bash
|
||
cat admin-panel/.env
|
||
# VITE_API_URL=http://127.0.0.1:8001 olmalı
|
||
```
|
||
|
||
### CORS Hatası
|
||
|
||
`backend/main.py` içinde frontend portunu ekle:
|
||
```python
|
||
allow_origins=[
|
||
"http://localhost:5173",
|
||
"http://localhost:5174", # Yeni port
|
||
"http://127.0.0.1:5173",
|
||
...
|
||
]
|
||
```
|
||
|
||
### ModuleNotFoundError
|
||
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### Node.js Modül Hatası
|
||
|
||
```bash
|
||
cd admin-panel
|
||
rm -rf node_modules package-lock.json
|
||
npm install
|
||
```
|
||
|
||
### Database Locked
|
||
|
||
```bash
|
||
pkill -f "python.*main.py"
|
||
cd backend
|
||
python3 main.py
|
||
```
|
||
|
||
## Platform-Specific
|
||
|
||
### macOS
|
||
|
||
```bash
|
||
brew install python@3.11 node@18
|
||
```
|
||
|
||
### Ubuntu/Debian
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install python3.11 python3-pip python3-venv
|
||
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
|
||
sudo apt install -y nodejs
|
||
```
|
||
|
||
### Windows (WSL2)
|
||
|
||
```powershell
|
||
wsl --install
|
||
```
|
||
Sonra Ubuntu talimatlarını takip edin.
|
||
|
||
## Geliştirme Modu
|
||
|
||
**Backend (auto-reload):**
|
||
```bash
|
||
cd backend
|
||
uvicorn main:app --reload --log-level debug --port 8001
|
||
```
|
||
|
||
**Frontend (debug):**
|
||
```bash
|
||
cd admin-panel
|
||
npm run dev -- --debug
|
||
```
|
||
|
||
## Doğrulama
|
||
|
||
```bash
|
||
# Backend test
|
||
curl http://127.0.0.1:8001/categories/main
|
||
|
||
# Frontend
|
||
# http://localhost:5173 tarayıcıda aç
|
||
```
|
||
|
||
## Bakım
|
||
|
||
### Haftalık
|
||
- Cache temizliği: `rm -rf reports/enrich_*/`
|
||
- Disk kontrolü: `df -h`
|
||
|
||
### Aylık
|
||
- Database yedekleme
|
||
- Dependency güncelleme (test ettikten sonra)
|
||
|
||
### Temizlik
|
||
|
||
```bash
|
||
# Python cache
|
||
find . -type d -name __pycache__ -exec rm -rf {} +
|
||
|
||
# npm cache
|
||
npm cache clean --force
|
||
|
||
# Eski raporlar
|
||
find reports/ -name "*.json" -mtime +30 -delete
|
||
```
|
||
|
||
---
|
||
|
||
**Son Güncelleme**: Ocak 2025
|