pezkuwi-wallet-android/docs/PACKAGE_STRUCTURE_REBRAND.md

Package Structure Rebrand Guide

Tarih: 2026-01-23 Durum: BEKLEMEDE - Büyük değişiklik, dikkatli planlama gerektirir

---

Mevcut Durum

Öğe	Sayı
io.novafoundation package referansları	~49,041
Etkilenen Kotlin/Java dosyaları	~2,000+
Module sayısı	65+

---

Hedef Dönüşüm

io.novafoundation.nova  →  io.pezkuwichain.wallet

Örnekler:

Mevcut	Hedef
io.novafoundation.nova.app	io.pezkuwichain.wallet.app
io.novafoundation.nova.common	io.pezkuwichain.wallet.common
io.novafoundation.nova.feature_wallet_api	io.pezkuwichain.wallet.feature_wallet_api
io.novafoundation.nova.runtime	io.pezkuwichain.wallet.runtime

---

Değişiklik Kapsamı

1. Dizin Yapısı Değişikliği

Her modülde:

src/main/java/io/novafoundation/nova/
    ↓
src/main/java/io/pezkuwichain/wallet/

2. Package Declaration Değişikliği

Her Kotlin/Java dosyasının ilk satırı:

// ÖNCE:
package io.novafoundation.nova.feature_wallet_api.domain

// SONRA:
package io.pezkuwichain.wallet.feature_wallet_api.domain

3. Import Statement Değişikliği

// ÖNCE:
import io.novafoundation.nova.common.utils.Event
import io.novafoundation.nova.feature_account_api.domain.model.Account

// SONRA:
import io.pezkuwichain.wallet.common.utils.Event
import io.pezkuwichain.wallet.feature_account_api.domain.model.Account

---

Otomatik Rebrand Script

#!/bin/bash
# package_rebrand.sh
# DIKKAT: Bu script'i çalıştırmadan önce backup alın!

WALLET_DIR="/home/mamostehp/pezWallet/pezkuwi-wallet-android"
OLD_PACKAGE="io.novafoundation.nova"
NEW_PACKAGE="io.pezkuwichain.wallet"
OLD_PATH="io/novafoundation/nova"
NEW_PATH="io/pezkuwichain/wallet"

# 1. Dizin yapısını değiştir
find "$WALLET_DIR" -type d -path "*/$OLD_PATH" | while read dir; do
    new_dir=$(echo "$dir" | sed "s|$OLD_PATH|$NEW_PATH|g")
    mkdir -p "$(dirname "$new_dir")"
    mv "$dir" "$new_dir"
done

# 2. Package declarations ve imports değiştir
find "$WALLET_DIR" -type f \( -name "*.kt" -o -name "*.java" \) | while read file; do
    sed -i "s|$OLD_PACKAGE|$NEW_PACKAGE|g" "$file"
done

# 3. build.gradle namespace'lerini kontrol et (zaten yapıldı)
# grep -rn "namespace" --include="*.gradle" "$WALLET_DIR"

echo "Rebrand tamamlandı. Build test edin."

---

Riskler ve Dikkat Edilmesi Gerekenler

1. Android Resource ID'leri

• R.drawable.*, R.string.* gibi resource referansları etkilenmez
• Ama BuildConfig referansları güncellenebilir

2. Dagger/Hilt Dependency Injection

• Component, Module, Scope annotation'ları
• Generated kod yeniden oluşturulmalı (clean build)

3. Room Database

• Entity, DAO sınıfları
• Migration'lar kontrol edilmeli

4. ProGuard/R8

• proguard-rules.pro dosyalarındaki referanslar

5. AndroidManifest.xml

• Activity, Service, Provider tanımları
• Intent filter'lar

6. Test Dosyaları

• androidTest ve test klasörlerindeki dosyalar da değişmeli

---

Önerilen Yaklaşım

Faz 1: Hazırlık (1-2 gün)

1. Mevcut durumun tam backup'ı
2. Tüm testlerin geçtiğini doğrula
3. CI/CD pipeline'ı geçici olarak durdur

Faz 2: Otomatik Dönüşüm (2-4 saat)

1. Script'i çalıştır
2. Build hatalarını kontrol et
3. IDE'de proje yapısını yenile (Invalidate Caches)

Faz 3: Manuel Düzeltmeler (1-2 gün)

1. Build hatalarını düzelt
2. Dagger/Hilt generated kod sorunları
3. ProGuard kuralları güncelle

Faz 4: Test (1 gün)

1. Unit test'leri çalıştır
2. Integration test'leri çalıştır
3. Manual UI testing
4. APK build ve install test

Faz 5: Finalize

1. Commit ve push
2. CI/CD'yi yeniden aktif et
3. Release build test

---

Alternatif: Kademeli Rebrand

Eğer tek seferde yapmak riskli görünüyorsa:

1. Modül bazlı değişiklik - Her modülü ayrı ayrı rebrand et
2. Alias kullanımı - Geçiş döneminde typealias ile uyumluluk
3. Git branch - Ayrı bir branch'te çalış, test et, merge et

---

Zaten Tamamlanan İşler

✅ Gradle namespace'ler: io.novafoundation.nova.* → io.pezkuwichain.wallet.* ✅ Display name'ler: "Nova Wallet" → "Pezkuwi Wallet" ✅ Deep link scheme: novawallet:// → pezkuwiwallet:// ✅ JavaScript interface: Nova_* → Pezkuwi_* ✅ Backup dosya adları: novawallet_backup.json → pezkuwiwallet_backup.json ✅ User-Agent: "Nova Wallet (Android)" → "Pezkuwi Wallet (Android)" ✅ Nevroz fire branding asset'leri

---

Sonuç

Bu değişiklik büyük ve riskli. Yapılması tavsiye edilir ama dikkatli planlama ile:

1. Şu an için: Mevcut durum çalışır durumda, build alınabilir
2. Kısa vadede: Package structure değişikliği planlanmalı
3. Uzun vadede: Tamamen io.pezkuwichain.wallet kullanılmalı

Öneri: Önce mevcut haliyle release build alıp test edin. Ardından bu değişikliği ayrı bir sprint'te planlayın.