MESA Core · v0.9.3
Dokümantasyon haritası
Bu rehberin Türkçe ve İngilizce sürümleri aynı konuyu açıklar. Bu sayfayla ilgili kaynak bölümleri en altta yer alır.
Belgeleri hangi sırayla okumalı?#
Önce kurulum ve model kullanmayan hızlı başlangıçla sistemi deneyin. Ardından kaynak kimliği, veri alımı, mimari ve arama konularını okuyun. Uygulamanızı sürümlenmiş API, SDK veya MCP üzerinden bağlayabilirsiniz. Sistemi işletecekseniz güvenlik, yapılandırma, kurtarma, yeniden oluşturma ve sürüm geçişi rehberlerini birlikte değerlendirin. Eski denetimler ve mimari kararlar geçmişi açıklar; güncel davranış için tek başına dayanak değildir.
Konuya göre devam edin#
Mimari, API, işletim ve sürüm sınırları sayfaları temel başvuru noktalarıdır. Tam belge listesi aşağıdaki özgün kaynakta yer alır.
Kaynak belgedeki ilgili bölümler
Bu bölüm, kaynak belgenin bu sayfayla ilgili kısımlarını değiştirmeden gösterir. Kaynak içindeki bir bölüme giden bağlantıyı açtığınızda metin otomatik olarak görünür.
Bu klasörde 12 kullanım/geliştirme rehberi ve 8 mimari karar belgesi vardır.
Hepsini sırayla okumak gerekmez. Amacınıza göre aşağıdaki giriş noktasını seçin.
Paket sürümü 0.9.3; V4 güncel API'dir.
Nereden başlamalıyım?#
| Amacınız | Okuyacağınız belge |
|---|---|
| MESA'yı kurup ilk örneği çalıştırmak | Kurulum ve ilk çalıştırma |
| Model, provider, port veya kapasite ayarlamak | Yapılandırma |
| HTTP, Python SDK veya terminal komutlarıyla kullanmak | API, SDK ve CLI |
| Codex/Antigravity bağlamak | MCP rehberi |
| Tenant, dataset, revision ve mutation kavramlarını anlamak | Kavramlar ve veri ekleme |
| Sistemin modüllerini ve sınırlarını anlamak | Mimari |
| Arama puanlarını, grafı ve context'i anlamak | Arama ve graf |
| Yetki, yedekleme, hata veya yükseltme işlemi yapmak | Operasyon rehberi |
| Mevcut V4 verisinden vektör/graf depolarını yeniden üretmek | Projection rebuild |
| Erişim ve veri güvenliği sınırlarını öğrenmek | Güvenlik |
| Testleri çalıştırmak ve CI sonuçlarını anlamak | Test ve CI |
| Yeni sürüm yayımlamak | Release prosedürü |
Birleştirilen konular nerede?#
- Docker ve çalışma profilleri: kurulum.
- Terminal komutları: CLI.
- MCP yönetim endpoint'leri ve onay kimlikleri: control API.
- Hata tablosu: troubleshooting.
- Eski V4 verisini yükseltme: v0.8.0 upgrade.
- Diğer MESA projelerinin sorumlulukları: ekosistem.
- Kapasite ve desteklenmeyen özellikler: sınırlar.
- GitHub kontrollerinin kapsamı: CI.
- v0.8.1 yayın durumu ve istisnaları: CHANGELOG.
Tasarım kararları ve teknik dosyalar#
ADR dizini, tasarımın neden seçildiğini açıklar. Yedi güncel
karar ayrı dosyadadır; emekli kararların kısa tarihçesi dizindedir. Tarihsel
kararlar mevcut özellik veya performans garantisi değildir.
OpenAPI snapshot, üretilmiş API şemasıdır; çalışan
uygulamanın /openapi.json çıktısı ve route/schema kodu güncel otoritedir.
Prometheus kuralları izleme sistemine yüklenen alarm
kurallarıdır; Markdown rehberi değildir.
Belgeleri güncel tutma#
Her konu için yukarıdaki ana belgeyi güncelleyin; aynı konuyu anlatan yeni
“final/latest/current” dosyaları açmayın. API/paket sürümü, V3/V4 ayrımı,
uygulanmış özellik ve ölçülmüş sonuç birbirine karıştırılmamalıdır.
Üretim uygunluğu release kapıları ile değerlendirilir; birim test
başarısı veya sürüm numarası production GO değildir.
Taşımalarda bağlantıları ve doküman testlerini birlikte güncelleyin; ardından
test rehberindeki doküman kontrolünü çalıştırın. Eski tam metinler
Git geçmişindedir. for_mvp/ çalışma planıdır ve bu düzenlemenin dışındadır.
