Notes

Bir kıdemli yazılım mimarı, veri analisti ve UI/UX uzmanı gibi davran. Amaç, demo olmayan, gerçek şirketlerin kullanabileceği seviyede bir “Satış Raporlama ve Veri Analizi Sistemi” geliştirmektir.

## 🎯 PROJE AMACI

Bu sistem, kullanıcıdan anlık veya toplu olarak alınan satış verilerini işleyerek:

* Anlamlı özetler üretir
* Yönetim kararlarını destekler
* Görsel raporlar sunar
* Performans analizi yapar

## 🧱 TEKNOLOJİLER (ZORUNLU)

* Backend: PHP 8+ (OOP)
* Veritabanı: MySQL (InnoDB)
* Frontend: HTML5, CSS3 (SCSS), JavaScript (Vanilla veya Alpine.js)
* Grafikler: Chart.js veya ApexCharts
* Mimari: MVC (zorunlu)
* API: RESTful yapı

## 🧠 MİMARİ YAPI

MVC uygulanmalı:

* Models → veri işleme ve sorgular
* Views → UI (component tabanlı)
* Controllers → iş akışı

Ek olarak:

* Service Layer (analitik hesaplamalar için)
* Repository Pattern (veri erişim soyutlama)

## 📁 KLASÖR YAPISI

/app
/controllers
/models
/services
/repositories
/views
/core
/config
/routes
/public
/assets (css, js, img)
/storage (logs, exports)

## 🗄️ VERİTABANI TASARIMI

### users

* id
* name
* email
* password
* role
* created_at

### products

* id
* name
* category_id
* price
* created_at

### categories

* id
* name

### regions

* id
* name

### sales

* id
* product_id (FK)
* quantity
* total_price
* region_id (FK)
* sale_date

### reports_cache (performans için)

* id
* report_type
* data (JSON)
* created_at

## ⚙️ ANA ÖZELLİKLER

### 1. Satış Veri Girişi

* Manuel giriş formu
* CSV/Excel import
* API ile veri kabul etme (POST endpoint)

### 2. Dashboard (ANA EKRAN)

Gösterilecek metrikler:

* Toplam satış (₺)
* Toplam adet
* Ortalama sipariş değeri
* Günlük / haftalık / aylık trend grafikleri

### 3. Ürün Bazlı Analiz

* En çok satan ürünler (top N)
* En yüksek ciro yapan ürünler
* En düşük performanslı ürünler
* Kar marjı analizi (opsiyonel)

### 4. Bölge / Kategori Analizi

* Bölge bazlı satış dağılımı (pie chart)
* Kategori bazlı performans
* Isı haritası (opsiyonel advanced)

### 5. Performans Analizi

* Büyüme oranı (%)
* Önceki dönem karşılaştırma
* Trend analizi

### 6. Akıllı İçgörüler (ÖNEMLİ)

Sistem otomatik yorum üretmeli:

* “X ürünü son 7 günde %30 artış gösterdi”
* “Y kategorisi düşüş trendinde”
* “Z bölgesi en yüksek büyümeyi sağladı”

(Bu analizler backend’de hesaplanmalı)

### 7. Filtreleme Sistemi

* Tarih aralığı
* Ürün
* Bölge
* Kategori

### 8. Raporlama

* PDF export (dompdf)
* Excel export
* Zamanlanmış rapor üretimi (cron)

## 🔐 GÜVENLİK

* password_hash kullan
* CSRF koruması
* XSS koruması
* SQL injection önleme (prepared statements)
* RBAC (admin / analyst / viewer)

## 🎨 UI / UX (KRİTİK)

Tasarım sıradan OLMAMALI:

* Modern admin dashboard (inspiration: Stripe Dashboard, Notion Analytics)
* Grid tabanlı layout
* Responsive (mobile-first)
* Dark mode
* Data visualization odaklı tasarım
* Skeleton loading
* Hover analytics (tooltip detayları)
* Sticky filtre bar
* Minimal ama güçlü tasarım

## 📊 GRAFİKLER

* Line chart → satış trendi
* Bar chart → ürün performansı
* Pie chart → kategori dağılımı
* Area chart → büyüme

## 📡 API

* POST /sales → veri ekleme
* GET /reports → rapor çekme
* GET /analytics → özet veriler

Response formatı:

{
"success": true,
"data": {},
"message": ""
}

## ⚡ PERFORMANS

* Büyük veri için indeksleme
* Cache sistemi (raporlar için)
* Lazy loading
* Pagination

## 🧪 TEST

* Form validation (frontend + backend)
* Hata loglama
* Exception handling sistemi

## 🚀 GELİŞTİRME ADIMLARI

Yapay zekâ şu sırayla ilerlemeli:

1. Veritabanı ve tablolar
2. MVC altyapısı
3. Authentication sistemi
4. Satış veri giriş modülü
5. Analitik servis katmanı
6. Dashboard geliştirme
7. Grafik entegrasyonu
8. Filtreleme sistemi
9. Akıllı içgörü üretimi
10. Raporlama sistemi
11. API geliştirme
12. Performans optimizasyonu
13. UI/UX iyileştirme

Her aşamada çalışan kod üretilmeli.

## ⚠️ KURALLAR

* Demo kod YASAK
* Eksik modül bırakma
* Production seviyesinde yaz
* DRY ve SOLID prensipleri uygula
* Kod okunabilir ve modüler olmalı

## 🎯 HEDEF

Bu sistem, gerçek bir şirketin satış analitiği ihtiyacını karşılayacak seviyede olmalıdır. Tüm modüller eksiksiz tamamlanana kadar geliştirme devam etmelidir.