ferox CLAUDE.md

pgclient — CLAUDE.md

Proje Özeti

Hafif bir masaüstü PostgreSQL client uygulaması. Rust + egui/eframe ile yazılmış. Hedef: DBeaver/DataGrip'e alternatif, <50MB RAM, <200ms startup.

Gerçek ölçümler (v0.2.3): ~45–47 MB RAM, 6.9 MB binary (release LTO)

Tech Stack

• GUI: egui 0.27 + eframe (immediate-mode, pure Rust; accesskit devre dışı)
• DB Driver: tokio-postgres 0.7 (async, pure Rust; simple_query text protokol)
• Async: tokio (current-thread runtime, ayrı std::thread içinde)
• TLS: native-tls + postgres-native-tls
• SSH: russh 0.44
• Config: serde + toml
• Export: serde_json + manuel CSV
• File Dialog: rfd 0.14 (native OS diyaloğu)
• SQL Highlighting: sıfırdan yazılmış tokenizer — src/ui/syntax.rs (syntect yok)
• i18n: sıfırdan yazılmış — src/i18n.rs (sıfır bağımlılık)

Mimari — Kritik Kural

UI thread (eframe) ↔ DB thread arası haberleşme SADECE mpsc kanalları ile:

• Sender<DbCommand> → UI'dan DB'ye komut
• Sender<DbEvent> → DB'den UI'a sonuç
• DB thread kendi current_thread tokio runtime'ını std::thread::spawn içinde oluşturur
• spawn_blocking ile sync recv, sonra async tokio-postgres

Bu pattern'i ASLA değiştirme. eframe main thread'i bloke eden hiçbir şey yapma.

Modül Yapısı

src/
├── main.rs           — eframe init, current_thread tokio runtime
├── app.rs            — PgClientApp, eframe::App impl, event loop
├── config.rs         — ConnectionProfile, AppConfig (TOML)
├── history.rs        — QueryHistory (kalıcı, max 500)
├── snippets.rs       — Saved queries (Ctrl+Shift+S, name+SQL, TOML-persisted)
├── i18n.rs           — Lang enum (En|Tr), I18n(pub Lang) newtype, ~100+ method
├── logger.rs         — crash log (panic hook)
├── db/
│   ├── mod.rs
│   ├── connection.rs — DbCommand/DbEvent, db_worker, execute_query (simple_query)
│   ├── query.rs      — CellValue enum, QueryResult
│   ├── metadata.rs   — Schema/table/column/index/FK introspection
│   └── ssh.rs        — SSH tunnel (russh)
└── ui/
    ├── mod.rs
    ├── sidebar.rs        — SidebarAction, schema tree, context menu
    ├── query_panel.rs    — SQL editör, BrowseState, sayfalama
    ├── result_table.rs   — egui_extras::TableBuilder, sort, inline edit
    ├── tab_manager.rs    — Tab lifecycle, yönlendirme, sağ-tık menüsü
    ├── connection_dialog.rs
    ├── dashboard.rs      — DB dashboard (tablo boyutları, bağlantılar, index)
    ├── explain.rs        — EXPLAIN ANALYZE ağaç görünümü
    ├── er_diagram.rs     — ER diyagramı
    ├── autocomplete.rs   — Tablo/sütun otomatik tamamlama
    └── syntax.rs         — Sıfırdan SQL tokenizer (keyword/type/string/comment)