trendyol-analiz/docs/SETUP_GUIDE.md

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ü

python3 --version  # 3.8+
node --version     # v18+
npm --version      # 9+

Hızlı Kurulum

1. Dependency Kurulumu

Backend:

cd backend
pip install -r requirements.txt

Frontend:

cd admin-panel
npm install

2. Uygulamayı Başlat

Otomatik (Önerilen):

python3 start.py

Manuel:

# 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)

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:

cd backend
python3 -c "from database import init_db; init_db()"

Database Yedekleme

cp backend/trendyol.db backend/trendyol.db.backup

Sorun Giderme

Port Çakışması

# 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:

curl http://127.0.0.1:8001/

2. .env dosyasını kontrol et:

cat admin-panel/.env
# VITE_API_URL=http://127.0.0.1:8001 olmalı

CORS Hatası

backend/main.py içinde frontend portunu ekle:

allow_origins=[
    "http://localhost:5173",
    "http://localhost:5174",  # Yeni port
    "http://127.0.0.1:5173",
    ...
]

ModuleNotFoundError

cd backend
pip install -r requirements.txt

Node.js Modül Hatası

cd admin-panel
rm -rf node_modules package-lock.json
npm install

Database Locked

pkill -f "python.*main.py"
cd backend
python3 main.py

Platform-Specific

macOS

brew install python@3.11 node@18

Ubuntu/Debian

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)

wsl --install

Sonra Ubuntu talimatlarını takip edin.

Geliştirme Modu

Backend (auto-reload):

cd backend
uvicorn main:app --reload --log-level debug --port 8001

Frontend (debug):

cd admin-panel
npm run dev -- --debug

Doğrulama

# 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

# 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