# Homelli Snippet - Proje Yapısı

## 📁 Klasör Organizasyonu

```
HomelliSnippetYeni/
│
├── 📁 homelli-snippet/          ⭐ CHROME EKLENTİSİ (Buradan geliştirme yapın!)
│   ├── manifest.json
│   ├── background/
│   ├── content/
│   ├── icons/
│   ├── lib/
│   ├── popup/
│   ├── options/
│   └── README.md
│
├── 📁 server/                   🌐 SUNUCU DOSYALARI (Hosting'e yükleyin)
│   ├── api.php
│   ├── config.php
│   ├── database.sql
│   ├── .htaccess
│   └── README.md
│
└── 📄 Dokümantasyon             📚 REFERANS DOSYALARI
    ├── README.md                 → Ana dokümantasyon
    ├── CHANGELOG.md              → Versiyon geçmişi
    ├── SETUP-GUIDE.md            → Kurulum rehberi
    ├── QUICK-REFERENCE.md        → Hızlı referans
    ├── VERSION-1.2.0.md          → Sürüm notları
    ├── BRANDING-UPDATE.md        → Branding özeti
    ├── SYNC-FEATURE-COMPLETE.md  → Sync özelliği
    └── OPTIONS-PAGE-COMPLETE.md  → Options page özeti
```

---

## 🎯 Kullanım Kılavuzu

### 1️⃣ Geliştirme Yaparken

**Çalışma Klasörü:** `homelli-snippet/`

```bash
# Kod değişikliği yap
cd homelli-snippet/
# Dosyaları düzenle...

# Chrome'da test et
chrome://extensions/ → Yenile (🔄)
```

### 2️⃣ Chrome'a Yükleme

```bash
1. chrome://extensions/ aç
2. "Geliştirici modu" aktif et
3. "Paketlenmemiş öğe yükle" tıkla
4. "homelli-snippet" klasörünü seç
```

### 3️⃣ Sunucu Kurulumu

**Çalışma Klasörü:** `server/`

```bash
1. cPanel File Manager aç
2. public_html/snippet-api/ oluştur
3. server/ içindeki dosyaları yükle
4. config.php düzenle (DB bilgileri)
```

---

## 📂 Detaylı Açıklama

### `homelli-snippet/` - Chrome Eklentisi ⭐

**Amaç:** Chrome'a yüklenecek eklenti dosyaları

**İçerik:**
- `manifest.json` - Eklenti yapılandırması
- `background/` - Arka plan script'leri
- `content/` - Sayfa içi script'ler (snippet injection)
- `icons/` - Eklenti ikonları (16, 48, 128px)
- `lib/` - Yardımcı kütüphaneler (storage, sync, utils)
- `popup/` - Popup arayüzü (HTML, CSS, JS)
- `options/` - Yönetim paneli (HTML, CSS, JS)

**Geliştirme:**
```bash
# Bu klasörde çalışın!
cd homelli-snippet/

# Değişiklik yaptıktan sonra:
chrome://extensions/ → Yenile
```

---

### `server/` - Sunucu Dosyaları 🌐

**Amaç:** Snippet senkronizasyonu için backend

**İçerik:**
- `api.php` - REST API endpoint'leri
- `config.php` - Veritabanı ve API ayarları
- `database.sql` - MySQL tablo şeması
- `.htaccess` - Güvenlik ayarları
- `README.md` - Kurulum talimatları

**Kurulum:**
```bash
1. cPanel → MySQL Databases
2. Veritabanı oluştur
3. database.sql çalıştır
4. Dosyaları yükle
5. config.php düzenle
```

---

### Dokümantasyon Dosyaları 📚

**Amaç:** Referans ve rehberler

| Dosya | Açıklama |
|-------|----------|
| `README.md` | Ana dokümantasyon, özellikler, kullanım |
| `CHANGELOG.md` | Tüm versiyon değişiklikleri |
| `SETUP-GUIDE.md` | Adım adım kurulum rehberi |
| `QUICK-REFERENCE.md` | Hızlı referans kartı |
| `VERSION-1.2.0.md` | v1.2.0 sürüm notları |
| `BRANDING-UPDATE.md` | İsim ve versiyon güncellemesi |
| `SYNC-FEATURE-COMPLETE.md` | Sync özelliği detayları |
| `OPTIONS-PAGE-COMPLETE.md` | Options page detayları |

---

## 🔄 Geliştirme Akışı

### Yeni Özellik Eklerken:

```bash
1. homelli-snippet/ klasöründe kod yaz
2. chrome://extensions/ → Yenile
3. Test et
4. Çalışıyorsa commit et
5. Gerekirse server/ dosyalarını güncelle
```

### Versiyon Güncellerken:

```bash
1. homelli-snippet/manifest.json → version değiştir
2. CHANGELOG.md → yeni versiyon ekle
3. Test et
4. Diğer bilgisayarlarda yenile
```

---

## ✅ Kontrol Listesi

### Eklenti Geliştirme
- [ ] `homelli-snippet/` klasöründe çalış
- [ ] Değişiklik yap
- [ ] Chrome'da yenile ve test et
- [ ] Çalışıyorsa kaydet

### Sunucu Güncelleme
- [ ] `server/` klasöründe değişiklik yap
- [ ] Hosting'e yükle
- [ ] API'yi test et
- [ ] Eklentide sync test et

### Dokümantasyon
- [ ] Büyük değişikliklerde README.md güncelle
- [ ] CHANGELOG.md'ye ekle
- [ ] Versiyon notları oluştur

---

## 🎯 Önemli Notlar

### ⚠️ Dikkat!

1. **Geliştirme:** Sadece `homelli-snippet/` klasöründe yapın
2. **Chrome:** Bu klasörü Chrome'a yükleyin
3. **Sunucu:** `server/` klasörünü hosting'e yükleyin
4. **Dokümantasyon:** Ana klasördeki .md dosyaları referans için

### 💡 İpuçları

- Kod değişikliği → `homelli-snippet/` içinde
- Sunucu değişikliği → `server/` içinde
- Her değişiklikten sonra Chrome'da yenile
- Sync özelliği sayesinde veriler korunur

---

## 📞 Yardım

Sorun yaşarsanız:
1. İlgili README.md dosyasına bakın
2. CHANGELOG.md'de benzer sorunları arayın
3. Chrome console'u kontrol edin (F12)

---

**Homelli Snippet v1.2.0** - [homelli.com.tr](https://homelli.com.tr)

*Temiz, organize, profesyonel!* ✨