30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
|
# 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.
|