Files
hcie-rust-v3.05/REFACTOR_TALIMATI.md
T
2026-07-09 02:59:53 +03:00

1.7 KiB
Raw Blame History

app/ Klasörü Refactor - Amaç ve Bağlam

Problem

hcie-gui-egui/src/app/ klasöründe 25+ dosya aynı düzeyde (flat), kategorisiz duruyor. Bu yüzden:

  • Sen (AI ajanı) bir değişiklik yaparken hangi dosyanın neyle ilişkili olduğunu kestiremiyorsun, sık sık ilgisiz modüllere sızıntı yapan bağımlılıklar ekliyorsun.
  • Zaman içinde aynı işi çözen birden fazla dosya oluşmuş olabilir (örn. dock_controller.rs / dock_engine.rs / grim_dock.rs gibi isim benzerlikleri şüpheli - muhtemelen biri diğerinin yeniden yazımı ve artık ölü kod).

Amaç

  1. Dosyaları mantıksal alt klasörlere ayır (panel'ler, docking/layout, dialoglar, dosya/format okuma, kullanıcı düzenleme aksiyonları gibi doğal kategoriler var - sen dosya isimlerine ve içeriklerine bakarak en uygun gruplamaya karar ver).
  2. Her alt klasörün mod.rs'i net bir sözleşme olsun: dışarıya sadece gerçekten ihtiyaç duyulan tipler/fonksiyonlar açılsın, geri kalanı private kalsın.
  3. Kullanılmayan (import edilmeyen) dosyaları tespit et ama SİLME - bana rapor et, silme kararını ben vereceğim.
  4. Davranışta hiçbir değişiklik olmamalı, sadece organizasyon değişsin.

Sınırlar

  • İçerik mantığını değiştirme, sadece taşı/organize et.
  • Emin olmadığın kararlarda (bir dosya iki kategoriye de uyuyorsa, ya da "kullanılmıyor" sandığın bir şey aslında kullanılıyorsa) bana sor, tahmin etme.
  • İlerlerken düzenli commit at ki geri dönebilelim.
  • Büyük değişiklik yapmadan önce bana planını kısaca özetle, onay al, sonra uygula.

Yöntemi (hangi sırayla ilerleyeceğini, hangi araçları kullanacağını) sen belirle.