numex_nedir/docs/mimari.md
numexai c189683464 Ekosistemi ayrintili anlat: Numex Ailesi, Codex, Hub/Forge, API, Market, Pedia, Okul, marka, ekran goruntuleri
- README Numex Ailesi yapisina gore yeniden duzenlendi, adresler ve ekran goruntuleri eklendi
- urunler/: 17 urun sayfasi (Codex Web/IDE/CLI, Core, API & SDK, Hub & Forge, Market, Numexpedia, Okul, Aile, marka kimligi...)
- docs/: mimari, yol haritasi & surum notlari, SSS, sozluk
- gorseller/: site ve uygulama ekran goruntuleri (kisisel bilgiler bulaniklastirildi)
2026-09-23 22:35:55 +00:00

2.9 KiB
Raw Blame History

🏗️ Numex Mimarisi

Katmanlar

flowchart TB
  subgraph Istemciler[İstemciler]
    W[🌐 Web / PWA]
    CX[🧩 Codex Web · IDE · VS Code]
    CLI[⌨️ CLI]
    SDK[🧰 SDK / API istemcileri]
    OK[🎓 Okul]
    HUB[📦 Hub]
  end
  subgraph Sunucu[Numex Sunucu Katmanı · Türkiye]
    AUTH[🔐 OAuth · JWT · API anahtarları · cihaz kodu]
    ROUTER[🧭 Router · plan ve profil seçimi]
    PIPE[⚡ Pipeline · Boru 1 → Motor → Boru 2A → Boru 2B]
    DET[🕵️ Detective Mode™]
    MA[🤖 Multi-Agent Orkestratör]
    DV[🔬 DeepView™]
    TOOLS[🧰 Araçlar · web arama · kod çalıştırma · belge · vision · görsel · embedding]
  end
  subgraph Core[🏛️ Numex Core · istemci tarafı ajan motoru]
    SW[Swarm Council]
    FG[FinishGate]
    SH[Self-Healing]
    MEM[Self-Evolving Memory · .numex/]
    INF[3 katmanlı çıkarım · ONNX WASM → Ollama → Bulut]
  end
  subgraph Veri[Veri & Git]
    DB[(MongoDB)]
    FORGE[(🏗️ Forge · Gitea)]
  end
  subgraph Saglayici[Model sağlayıcıları]
    LLM[Google Cloud · Azure · Anthropic · Meta · DeepSeek]
  end

  W & SDK & OK & HUB --> AUTH --> ROUTER
  CX & CLI --> Core
  Core --> ROUTER
  ROUTER --> PIPE --> LLM
  PIPE --> DET & MA
  MA --> DV
  ROUTER --> TOOLS
  ROUTER --> DB
  HUB --> FORGE
  CX --> FORGE

Bir isteğin yolculuğu

  1. Kimlik: OAuth oturumu, JWT veya nx_live_ API anahtarı doğrulanır.
  2. Router: Kullanıcının planı ve seçtiği profil (Pro/Fast/Vision/Code) tespit edilir; istek uygun işlem hattına yönlendirilir.
  3. Boru 1: Prompt güçlendirme, bağlam ekleme, uzman talimatları; @karakter varsa profil yüklenir.
  4. Mod tespiti: Kritik soru → Detective Mode; çok alanlı soru / 2+ @uzman → DeepView / Multi-Agent; araç gerekiyorsa (web, kod, belge) → araçlar.
  5. AI Motor: İş ortağı model(ler) yanıt üretir.
  6. Boru 2A: Türkçe düzeltme, format, ton.
  7. Boru 2B: Kalite kontrol ve doğrulama.
  8. Yanıt: Akışlı (stream) olarak istemciye; sohbet geçmişi saklanır.

Ajan tarafı (Core)

Codex ve CLI'de ajan kullanıcının bilgisayarında çalışır: dosyaları okur/yazar, komut çalıştırır, testleri koşar. Sunucudan yalnızca model çağrısı alır. Plan → onay → uygula → FinishGate kanıtı → hafızaya kaydet döngüsü izlenir. Proje hafızası .numex/ klasöründe açık dosyalar olarak durur.

Teknoloji yığını

Katman Teknoloji
Sunucu Node.js, Express, MongoDB, Redis, JWT, Passport (Google/GitHub OAuth)
Barındırma Vercel (fra1) + Türkiye'de çift sunucu (2×256 GB RAM, SAS + NAS)
Ödeme İyzico
Web arama Serper
Ajan motoru @numex-ai/core — Node 22+, node:sqlite, ONNX WASM, Ollama, Playwright
Editör VS Code / VSCodium tabanlı Codex IDE; Monaco (Codex Web); tree-sitter
Git Gitea (Forge)