docs: add multi-language documentation (ru, fa, zh, tr, ar)

2026-05-07 23:42:55 +03:00
parent abb382c419
commit e9d3c7e9de
157 changed files with 14339 additions and 0 deletions
@@ -0,0 +1,48 @@
+# LSM-Tree Depolama Motoru
+
+Log-Structured Merge-Tree mimarisini kullanan BaraDB'deki birincil depolama motoru.
+
+## Mimari
+
+```
+┌─────────────────────────────────────────────┐
+│                   Writes                     │
+│         (append to WAL + MemTable)           │
+└─────────────────────────────────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────────┐
+│                  MemTable                    │
+│         (in-memory sorted buffer)            │
+└─────────────────────────────────────────────┘
+                      │
+                      ▼
+┌─────────────────────────────────────────────┐
+│                  SSTable                     │
+│          (sorted string table on disk)       │
+└─────────────────────────────────────────────┘
+```
+
+## Kullanım
+
+```nim
+import barabadb/storage/lsm
+
+var db = newLSMTree("./data")
+
+db.put("key1", cast[seq[byte]]("value1"))
+
+let (found, value) = db.get("key1")
+
+db.delete("key1")
+
+db.close()
+```
+
+## Özellikler
+
+- **Yazma için optimize**: Append-only log yapısı
+- **Dayanıklılık**: WAL çökme kurtarma sağlar
+- **Bloom Filter**: Hızlı negatif aramalar
+- **Compaction**: Boyut katmanlı strateji
+- **Page Cache**: Sık erişilen sayfalar için LRU önbellek