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

30 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.