mirror of
https://github.com/nethunterzist/trendyol-analiz
synced 2026-07-01 09:27:03 +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>
74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
# Dokümantasyon
|
||
|
||
Trendyol Product Dashboard teknik dokümantasyon dizini.
|
||
|
||
## Dokümantasyon İndeksi
|
||
|
||
| Dosya | Açıklama | Öncelik |
|
||
|-------|----------|---------|
|
||
| [ARCHITECTURE.md](./ARCHITECTURE.md) | Sistem mimarisi ve tasarım (Türkçe) | Referans |
|
||
| [API_DOCUMENTATION.md](./API_DOCUMENTATION.md) | API endpoint referansı | Referans |
|
||
| [SETUP_GUIDE.md](./SETUP_GUIDE.md) | Kurulum ve sorun giderme | Başlangıç |
|
||
| **[DASHBOARD_ARCHITECTURE.md](./DASHBOARD_ARCHITECTURE.md)** | **Dashboard geliştirme rehberi** | **KRİTİK** |
|
||
| **[bug-fixes/ORIGINTAB_BUG_FIX.md](./bug-fixes/ORIGINTAB_BUG_FIX.md)** | **Alan adı uyumsuzluk pattern'i** | **KRİTİK** |
|
||
|
||
## Hızlı Başlangıç
|
||
|
||
### Yeni Geliştiriciler İçin
|
||
|
||
1. [../README.md](../README.md) - Proje genel bakış
|
||
2. [SETUP_GUIDE.md](./SETUP_GUIDE.md) - Kurulum
|
||
3. [ARCHITECTURE.md](./ARCHITECTURE.md) - Mimari
|
||
4. [API_DOCUMENTATION.md](./API_DOCUMENTATION.md) - API referansı
|
||
|
||
### Dashboard/Frontend Çalışması
|
||
|
||
**KRİTİK**: Dashboard koduna dokunmadan önce:
|
||
|
||
1. [DASHBOARD_ARCHITECTURE.md](./DASHBOARD_ARCHITECTURE.md) oku
|
||
2. [bug-fixes/ORIGINTAB_BUG_FIX.md](./bug-fixes/ORIGINTAB_BUG_FIX.md) oku
|
||
3. `admin-panel/src/components/ReportDashboard.jsx` incele
|
||
|
||
### Backend/API Çalışması
|
||
|
||
1. [API_DOCUMENTATION.md](./API_DOCUMENTATION.md) referans al
|
||
2. [ARCHITECTURE.md](./ARCHITECTURE.md) incele
|
||
3. `backend/main.py` kodunu incele
|
||
|
||
## Klasör Yapısı
|
||
|
||
```
|
||
docs/
|
||
├── README.md # Bu dosya
|
||
├── ARCHITECTURE.md # Sistem mimarisi (Türkçe)
|
||
├── API_DOCUMENTATION.md # API referansı
|
||
├── SETUP_GUIDE.md # Kurulum kılavuzu
|
||
├── DASHBOARD_ARCHITECTURE.md # Dashboard geliştirme rehberi
|
||
└── bug-fixes/
|
||
└── ORIGINTAB_BUG_FIX.md # Bug fix pattern referansı
|
||
```
|
||
|
||
## Dashboard Kuralları (Özet)
|
||
|
||
**YAPMA**:
|
||
- `all_products`'tan hesaplama yapma (`charts` varsa)
|
||
- Backend'i kontrol etmeden alan adı uydurma
|
||
- Console.log debugging'i atlama
|
||
|
||
**YAP**:
|
||
- Backend'in `charts` ve `kpis` objelerini kullan
|
||
- `ReportDashboard.jsx`'teki pattern'leri takip et
|
||
- Alan adlarını producer-consumer arası doğrula
|
||
- Dönüşümler için mapping layer pattern kullan
|
||
|
||
## İlgili Dosyalar
|
||
|
||
- [../README.md](../README.md) - Ana proje README
|
||
- [../CLAUDE.md](../CLAUDE.md) - Claude Code rehberi
|
||
- `../admin-panel/` - Frontend kaynak kodu
|
||
- `../backend/` - Backend kaynak kodu
|
||
|
||
---
|
||
|
||
**Son Güncelleme**: Ocak 2025
|