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)

README.md

@@ -2,210 +2,346 @@
 
 # ◆ Numex AI
 
-### Türkiye'nin yerli yapay zeka ekosistemi
+## Türkiye'nin yerli yapay zeka ekosistemi
 
-**Sohbet · Kod · Ajanlar · Belge analizi · Web araması — Türkçe'ye ve Türk kullanıcısına özel.**
+**Sohbet · Kod · Otonom ajanlar · Belge analizi · Web araması · Terminal · Editör · API**
+Türkçe'ye ve Türk kullanıcısına özel — verileri Türkiye'de, KVKK uyumlu.
 
 [![Web](https://img.shields.io/badge/web-numexai.com.tr-1de9b6)](https://numexai.com.tr)
-[![Kuruluş](https://img.shields.io/badge/kuruluş-2021%20·%20İstanbul-0b1f3a)](#-hikaye)
-[![KVKK](https://img.shields.io/badge/KVKK-uyumlu-22c55e)](#-gizlilik-ve-altyapı)
+[![Sürüm](https://img.shields.io/badge/platform-v3.1-0b1f3a)](docs/yol-haritasi.md)
+[![Kuruluş](https://img.shields.io/badge/kuruluş-2021%20·%20İstanbul-8b5cf6)](#-hikaye)
+[![KVKK](https://img.shields.io/badge/KVKK-uyumlu-22c55e)](urunler/12-guvenlik-kvkk.md)
+[![API](https://img.shields.io/badge/API-v1-f59e0b)](urunler/05-api-ve-sdk.md)
 [![Lisans](https://img.shields.io/badge/lisans-MIT-blue)](LICENSE)
 
-[**🚀 Ücretsiz başla**](https://numexai.com.tr) ·
-[**💳 Planlar**](#-planlar) ·
-[**⌨️ CLI**](#️-numex-cli) ·
-[**📚 Makaleler**](makaleler/)
+[🚀 Ücretsiz başla](https://numexai.com.tr) ·
+[🧩 Ürünler](urunler/) ·
+[👨‍👩‍👧‍👦 Aile](urunler/15-numex-ailesi.md) · [🏗️ Mimari](docs/mimari.md) ·
+[🗺️ Yol haritası](docs/yol-haritasi.md) ·
+[❓ SSS](docs/sss.md) ·
+[📚 Makaleler](makaleler/)
 
 </div>
 
 ---
 
 > *"Türkçe konuşan, Türk kültürünü anlayan bir yapay zeka neden yok?"*
-> Numex AI bu soruyla 2021'de yola çıktı.
+> Numex AI bu soruyla **2021**'de İstanbul'da yola çıktı. Bugün web'den terminale, editörden
+> Windows masaüstüne, işletme yazılımından geliştirici API'sine uzanan bir **ekosistem**.
 
-## İçindekiler
+## 📑 İçindekiler
 
-- [Numex AI nedir?](#-numex-ai-nedir)
-- [Neden farklı?](#-neden-farklı)
-- [Ürün ailesi](#-ürün-ailesi)
-- [Teknoloji](#-teknoloji)
-- [Numex profilleri](#-numex-profilleri)
-- [Türkçe karakter sistemi](#-türkçe-karakter-sistemi)
-- [Planlar](#-planlar)
-- [Gizlilik ve altyapı](#-gizlilik-ve-altyapı)
-- [Hikaye](#-hikaye)
-- [Makaleler](#-makaleler)
-- [İletişim](#-iletişim)
+1. [Bir bakışta Numex](#-bir-bakışta-numex)
+2. [Ekosistem haritası — Numex Ailesi](#️-ekosistem-haritası--numex-ailesi)
+3. [Ürünler](#-ürünler)
+4. [Numex'i farklı kılan teknoloji](#-numexi-farklı-kılan-teknoloji)
+5. [Profiller ve araçlar](#-profiller-ve-araçlar)
+6. [Türkçe karakterler](#-türkçe-karakterler)
+7. [Geliştiriciler için](#-geliştiriciler-için)
+8. [Planlar ve fiyatlar](#-planlar-ve-fiyatlar)
+9. [Güvenlik, gizlilik ve altyapı](#-güvenlik-gizlilik-ve-altyapı)
+10. [Hikaye](#-hikaye)
+11. [Değerler](#-değerler)
+12. [Dokümanlar ve makaleler](#-dokümanlar-ve-makaleler)
+13. [İletişim](#-iletişim)
 
 ---
 
-## ◆ Numex AI nedir?
+## ◆ Bir bakışta Numex
 
-**Numex AI**, 2021'den beri İstanbul'da geliştirilen, **Türkçe'ye ve Türk kullanıcısına özel tasarlanmış**
-bir yapay zeka platformudur. Amaç basit: yapay zekayı **anlaşılır, erişilebilir ve faydalı** kılmak.
+| | | |
+|---|---|---|
+| **2021** | Kuruluş · İstanbul | Kurucu: Nurullah Şahin |
+| **9+** | Yapay zeka modülü tek platformda | Sohbet, kod, görsel, ses, belge, arama… |
+| **4** | Numex profili | Pro · Fast · Vision · Code |
+| **128K** | Token bağlam penceresi | 300+ sayfalık belge tek seferde |
+| **5** | Katmanlı Pipeline motoru | Her yanıt Türkçe'ye özel işlenir |
+| **2 × 256 GB** | RAM, çift sunucu | SAS + NAS depolama |
+| **%100** | KVKK uyumu | Veriler Türkiye'de |
+| **100.000** | Hediye token | Geliştirici API'sinde ilk kayıtta |
+| **44** | Açık kaynak uygulama | Numex Market · 7 kategori · ₺0 |
+| **28** | Türkçe makale | Numexpedia · 8 kategori |
+| **16+** | Aile üyesi | Uygulamalar · Geliştirici araçları · Platform & topluluk |
+
+**Tek hesap, tüm ekosistem:** Google veya GitHub ile bir kez giriş yapın; web uygulaması, CLI,
+Codex IDE, Hub ve Forge aynı hesapla açılır.
+
+## 🗺️ Ekosistem haritası — Numex Ailesi
+
+> **Tek bir akıl, birçok kapı. Aracın değil, yoldaşın.** *Biz bir aileyiz.*
+> **NUMEX** — İnsanı önce koyan Türk yapay zekâsı.
+
+```mermaid
+flowchart TB
+    N["NUMEX · İnsanı önce koyan Türk yapay zekâsı"]
+    C["🔶 Core — Beyin · Hepsinin arkasındaki akıl, kod ve uygulama üretir"]
+    N --> C
+    subgraph U["🟢 Uygulamalar · HERKES"]
+      U1["💬 Numex — Sohbet & asistan"]
+      U2["🎓 Okul — Doğrulanmış testler"]
+      U3["🧩 Codex — Kod editörü"]
+      U4["🛍️ Market — Hazır uygulamalar"]
+    end
+    subgraph G["🔶 Geliştirici Araçları · YAZILIMCI"]
+      G1["⌨️ CLI — Terminalden"]
+      G2["🧰 SDK — Uygulamana göm"]
+      G3["🔌 API — Uzaktan bağlan"]
+    end
+    subgraph P["🟢 Platform & Topluluk · GELİŞTİRİCİ"]
+      P1["📦 Hub — Keşfet & çatalla"]
+      P2["🏗️ Forge — Kod deposu (Git)"]
+      P3["📖 Numexpedia — Türkçe ansiklopedi"]
+      P4["🎮 Oyun Bahçesi — 7'den 70'e oyunlar"]
+    end
+    C --> U
+    C --> G
+    C --> P
+    subgraph A["🤝 Aynı ekipten"]
+      A1["🧭 Pusulam — Ön muhasebe & POS"]
+      A2["🩺 PC Doktoru — Windows bakım"]
+    end
+```
+
+→ Ayrıntı: [Numex Ailesi](urunler/15-numex-ailesi.md) · [Marka kimliği — logonun gizli sırrı](urunler/17-marka-kimligi.md)
+
+### 🌐 Adresler
+
+| Adres | Ürün |
+|---|---|
+| [numexai.com.tr](https://numexai.com.tr) | Numex AI — sohbet & asistan (Web/PWA) |
+| [numexai.com.tr/aile](https://www.numexai.com.tr/aile) | Numex Ailesi haritası |
+| [codex.numexai.com.tr](https://codex.numexai.com.tr) | Numex Codex — IDE, VS Code eklentisi, CLI |
+| [okul.numexai.com.tr](https://okul.numexai.com.tr) | Numex Okul — doğrulanmış testler |
+| [market.numexai.com.tr](https://market.numexai.com.tr) | Numex Market — 44 açık kaynak uygulama |
+| [dene.numexai.com.tr](https://dene.numexai.com.tr/cyberbeats/) | Market uygulamalarının canlı demoları |
+| [hub.numexai.com.tr](https://hub.numexai.com.tr) | Numex Hub — AI depo yönetimi, Topluluk Vitrini |
+| [forge.numexai.com.tr](https://forge.numexai.com.tr) | Numex Forge — Gitea tabanlı Git sunucusu |
+| [pedia.numexai.com.tr](https://pedia.numexai.com.tr) | Numexpedia — özgür Türkçe ansiklopedi |
+| [pusulamx.com.tr](https://pusulamx.com.tr) | Pusulam — ön muhasebe & POS |
+| [pcdoktoru.com.tr](https://pcdoktoru.com.tr) | PC Doktoru — Windows bakım |
+
+## 🧩 Ürünler
+
+![Numex AI web](gorseller/web-sohbet.png)
+
+| | Ürün | Kimin için? | Özet | Ayrıntı |
+|---|---|---|---|---|
+| 💬 | **Numex AI** | Herkes | Türkçe sohbet, kod, görsel, ses, belge analizi, web araması, karakterler, Agent modu | [→](urunler/01-numex-ai-platform.md) |
+| 🎓 | **Numex Okul** | Öğrenci · veli · öğretmen | Bir AI soruyu üretir, ikinci AI doğrular; LGS/TYT/AYT/ehliyet; ekranda çöz veya PDF | [→](urunler/11-numex-okul.md) |
+| 🧩 | **Numex Codex** | Geliştirici | Türkçe kod ajanı: Web editör, masaüstü IDE (v2.9.59), VS Code eklentisi; Sohbet · Plan · Otonom · Hata Avcısı | [→](urunler/03-numex-codex-ide.md) |
+| 🛍️ | **Numex Market** | Herkes | Numex'in otonom ürettiği 44 ücretsiz, açık kaynak uygulama; 7 kategori | [→](urunler/13-numex-market.md) |
+| ⌨️ | **Numex CLI** | Geliştirici | Terminalde otonom ajan (v3.3.10), misyon/plan modu, uzaktan PC köprüsü, MCP | [→](urunler/02-numex-cli.md) |
+| 🧰 | **Codex SDK** | Geliştirici | Çekirdeği uygulamana göm: chat · embeddings · images · models · search · CLI Bridge | [→](urunler/05-api-ve-sdk.md) |
+| 🔌 | **Developer API** | Yazılım ekipleri | REST v1; `numex-pro` · `fast` · `think` · `vision` · `code`; streaming, function calling; ilk kayıtta 100K token | [→](urunler/05-api-ve-sdk.md) |
+| 📦 | **Numex Hub** | Geliştirici | Deposunu bilen AI; Topluluk Vitrini, Trend Depolar, Canlı Akış, çatalla | [→](urunler/06-hub-ve-forge.md) |
+| 🏗️ | **Numex Forge** | Geliştirici | Gitea tabanlı Türkçe Git sunucusu: konular, değişiklik istekleri, kilometre taşları | [→](urunler/06-hub-ve-forge.md) |
+| 📖 | **Numexpedia** | Herkes | 28 makale, 8 kategori; bilgisayar, AI ve yazılım sade Türkçe ile | [→](urunler/14-numexpedia.md) |
+| 🎮 | **Oyun Bahçesi** | 7'den 70'e | Otonom üretilmiş oyunlar | [→](urunler/16-oyun-bahcesi.md) |
+| 🏛️ | **Numex Core** | Çekirdek | Swarm Council, FinishGate, Self-Healing, Omni-Vision, 3 katmanlı çıkarım | [→](urunler/04-numex-core.md) |
+| 🔬 | **DeepView™** | Herkes / kurumsal | Çoklu uzman orkestratörü, Master Plan, 6 katmanlı düşünce | [→](urunler/07-deepview.md) |
+| 🇹🇷 | **Karakterler** | Herkes | @FatmaAna, @LokmanHekim, @Üstat, @MuhasebeciYunus, @Avukat, @Kod… | [→](urunler/08-karakterler.md) |
+| 🧭 | **Pusulam** | KOBİ | Ön muhasebe & POS | [→](urunler/10-pusulamx.md) |
+| 🩺 | **PC Doktoru** | Windows | Portable yapay zekalı bakım / teşhis / tamir | [→](urunler/09-pc-doktoru.md) |
+
+### 📸 Ekranlardan
 
 | | |
 |---|---|
-| **2021** | Kuruluş yılı · İstanbul |
-| **9+** | Yapay zeka modülü, tek platformda |
-| **2 × 256 GB** | RAM — çift sunucu altyapısı |
-| **%100** | KVKK uyumlu · Türkiye altyapısı |
+| ![Codex IDE](gorseller/codex-ide-ayarlar-swarm.png)<br/>**Codex IDE** — Numex Çözüm paneli, Swarm fazı | ![CLI](gorseller/cli-codex-acilis.png)<br/>**Numex Codex CLI** açılışı |
+| ![Hub](gorseller/hub-ozellikler.png)<br/>**Numex Hub** | ![Uzaktan CLI](gorseller/uzak-cli-web.png)<br/>**Uzaktan CLI** — tarayıcıdan PC'ye |
+| ![Planlar](gorseller/planlar-kartlar.png)<br/>**Planlar** | ![Logo](gorseller/marka-gizli-anlam.png)<br/>**Logo** — 180° çevrilince Selçuklu yıldızı |
 
-Aynı motor web'de, terminalde ve editörde çalışır: **nerede çalışıyorsanız Numex oradan devam eder.**
+## ⚡ Numex'i farklı kılan teknoloji
 
-## ✨ Neden farklı?
+**"Ham API değil — Türkçe'ye özel işlenmiş sistem."** Numex, dünya çapındaki model sağlayıcılarını
+kendi motorlarıyla sarar. Ayrıntılı anlatım: [Mimari](docs/mimari.md)
 
-**Ham API değil, Türkçe'ye özel işlenmiş bir sistem.** Numex her isteği doğrudan bir modele iletmek
-yerine kendi motorlarından geçirir:
-
-| | Özellik | Ne yapar? |
-|---|---|---|
-| ⚡ | **Pipeline Motoru** | Her istek 5 katmandan geçer: prompt güçlendirme → AI işleme → Türkçe düzeltme → format ayarı → kalite kontrol. |
-| 🕵️ | **Detective Mode™** | Kritik sorularda birden fazla model aynı soruyu bağımsız çözer; bir **hakem sistemi** en doğru yanıtı seçer. |
-| 🤖 | **Multi-Agent** | Orkestratör karmaşık isteği alt görevlere böler, uzman ajanlara dağıtır, sonucu tek tutarlı yanıtta birleştirir. |
-| 🇹🇷 | **Türkçe DNA** | *"Yapılmaktadır"* değil, *"yapılır"* diyen bir yapay zeka. Doğal, günlük Türkçe. |
-| 🔍 | **Numex DeepView™** | Yapay zekanın ne söylediğini değil, **nasıl düşündüğünü** 6 katmanda görselleştiren şeffaf mimari. |
-
-## 🧩 Ürün ailesi
-
-| Ürün | Açıklama |
-|---|---|
-| 🌐 **Numex AI — Web & PWA** | Kayıt olmadan tarayıcıdan deneyin; giriş yaptıktan sonra mobil/masaüstüne uygulama olarak ekleyin. Sohbet, kod, görsel, ses, belge analizi ve web araması. |
-| ⌨️ **Numex CLI** | Terminalden çalışan otonom kodlama asistanı. **Uzaktan PC** köprüsü ile web'den ya da telefondan kendi bilgisayarınıza komut gönderin. |
-| 🧩 **Numex Codex IDE** | VS Code altyapılı, yapay zeka entegreli masaüstü editör: sohbet, ajanlar, satır içi düzenleme ve terminal bir arada. |
-| 🤖 **Numex Agent** | Çok adımlı görevlerde planlayan ve dosyalarınıza doğrudan değişiklik uygulayan ajan. Her değişiklik **diff** olarak gösterilir, siz kabul/ret edersiniz. |
-| 🩺 **[PC Doktoru Süper Ajan](https://pcdoktoru.com.tr)** | Windows için yapay zeka destekli, portable bakım, teşhis ve tamir asistanı. ([Kaynak](https://github.com/mobilcep/pcdoktoru)) |
-| 🧭 **PusulamX** | İşletmeler için Numex gücü: KOBİ'lerin ön muhasebe ve POS süreçlerinde "X" çarpanıyla büyümesi. *(2026)* |
-| 🎓 **Numex Okul** | Yapay zeka destekli eğitim ve içerik üretimi. |
-
-### ⌨️ Numex CLI
-
-```powershell
-# Windows (PowerShell) — Node.js 18+ gerekir
-irm https://www.numexai.com.tr/install-cli.ps1 | iex
-numex basla          # tarayıcıda giriş + menü
-numex uzak install   # arka plan köprüsü (sistem tepsisinde Numex ikonu)
-```
-
-- 💬 **Terminal sohbeti:** Proje klasöründe ajan tabanlı asistan — dosya okuma/yazma, git, RAG arama.
-- 🖥️ **Uzaktan PC:** Telefondan veya başka bir cihazdan kendi PC'nize klasör, dosya ve shell komutu gönderin.
-- 🔑 Numex hesabınızın token bakiyesini veya API anahtarını kullanır.
-
-## ⚙️ Teknoloji
+### 1 · Pipeline Motoru (Boru Sistemi)
 
 ```
- 👤 Kullanıcı ──▶ ⚡ Boru 1 ──▶ 🤖 AI Motor ──▶ ✨ Boru 2A ──▶ 🧠 Boru 2B ──▶ ✅ Son yanıt
+👤 İstek ─▶ ⚡ Boru 1 ─▶ 🤖 AI Motor ─▶ ✨ Boru 2A ─▶ 🧠 Boru 2B ─▶ ✅ Yanıt
            prompt       iş ortağı       Türkçe düzeltme  kalite kontrol
            güçlendirme  modeli          format · ton     doğrulama
+           NUMEX ÖZEL   İŞ ORTAĞI       NUMEX ÖZEL       KALİTE
 ```
 
-**Detective Mode™ — "Tek model yanılabilir. Üçü birden yanılmaz."**
+İç değerlendirmelere göre ham API çıktısına kıyasla **3–5 kat** kalite artışı; v3.1'de Boru 2A ile
+Türkçe çıktı kalitesinde **%30** iyileşme.
 
-```
-                     Kullanıcı sorusu
-          ┌──────────────┼──────────────┐
-     ⚡ Hızlı analiz  🧠 Derin analiz  🎯 Alternatif bakış
-          └──────────────┼──────────────┘
-                ⚖️ Numex Hakem Sistemi
-                         ▼
-               🏆 Kazanan çözüm + gerekçe
-```
+### 2 · Detective Mode™ — "Tek model yanılabilir. Üçü birden yanılmaz."
 
-**Altyapı sağlayıcıları:** Google Cloud, Microsoft Azure, Anthropic, Vercel, Meta, MongoDB, DeepSeek.
-Veri işleme ve saklama Numex politikasına tabidir.
+Kritik sorularda **Hızlı analiz**, **Derin analiz** ve **Alternatif bakış** aynı soruyu bağımsız
+çözer; **Numex Hakem Sistemi** en doğru yanıtı gerekçesiyle seçer. Numex'in paylaştığı verilere göre
+tek modele kıyasla hata oranında %85'e varan azalma.
 
-**Geliştirici katmanı:** Node.js · Express · MongoDB · Vercel (fra1) · JWT/OAuth (Google, GitHub) · İyzico.
-`@numex-ai/core` çekirdeği CLI, VS Code eklentisi ve SDK tarafından ortak kullanılır (*"Süper SDK"* mimarisi).
+### 3 · Multi-Agent — parçala, dağıt, birleştir
 
-→ Ayrıntılar: [Pipeline, Detective Mode ve Multi-Agent](makaleler/02-pipeline-detective-multi-agent.md)
+Orkestratör karmaşık isteği alt görevlere böler (araştırma, özet, kod, mantık, risk…), uzman
+ajanlara paralel/sıralı dağıtır, hakem katmanı çakışmaları giderir, çıktı Pipeline'dan geçip tek
+tutarlı Türkçe yanıta dönüşür.
 
-## 🧠 Numex profilleri
+### 4 · DeepView™ — nasıl düşündüğünü görün
 
-| Profil | Kullanım | Öne çıkan |
+2+ `@uzman` etiketiyle tetiklenen çoklu uzman orkestratörü; tek entegre **Master Plan** üretir ve
+akıl yürütmeyi 6 katmanda gösterir (Thought Stream, Reasoning Panel, …).
+
+### 5 · Numex Core — kendi kendini iyileştiren ajan motoru
+
+**Swarm Council** (Mimar · Kodlayıcı · Denetçi · Tasarımcı), **3 katmanlı çıkarım**
+(ONNX WASM yerel → Ollama → Bulut), **Self-Healing Loop**, **FinishGate** (kanıtsız "bitti" yok),
+**Self-Evolving Memory** (`.agents/skills/`).
+
+## 🧠 Profiller ve araçlar
+
+| Profil | Rol | Öne çıkan | Plan |
+|---|---|---|---|
+| 🧠 **Numex Pro** | Birincil, genel amaçlı | 128K bağlam, derin analiz | Basic+ |
+| ⚡ **Numex Fast** | Anlık sohbet, hızlı tamamlama | Düşük gecikme | Basic+ |
+| 👁️ **Numex Vision** | Görsel anlama | Görsel analiz ve açıklama | Pro+ |
+| 💻 **Numex Code** | Yazılım görevleri | Debug · refactor · test · doküman | — |
+
+| Araç | İşlev | Plan |
 |---|---|---|
-| 🧠 **Numex Pro** | Genel amaçlı birincil profil | 128K bağlam, derin analiz |
-| ⚡ **Numex Fast** | Anlık sohbet, hızlı kod tamamlama | Düşük gecikme |
-| 👁️ **Numex Vision** | Görsel analiz ve açıklama | Görsel anlama |
-| 💻 **Numex Code** | Debug, refactor, test, dokümantasyon | Kod odaklı |
+| 🌐 Web arama | Güncel bilgiyi arayıp özetler | Basic+ |
+| ⚙️ Kod çalıştırma | Python/JS'yi güvenli ortamda çalıştırır | Pro+ · Beta |
+| 📄 Belge analizi | PDF/Word özetleme ve sorgulama | Ücretsiz |
+| 🤖 Agent modu | Çok adımlı planlama + diff ile uygulama | Pro+ |
 
-**Araçlar:** 🌐 Web arama · ⚙️ Kod çalıştırma (beta) · 📄 Belge analizi (PDF/Word) · 🤖 Agent modu
+## 🇹🇷 Türkçe karakterler
 
-## 🇹🇷 Türkçe karakter sistemi
+`@` ile çağrılan, Türk kültürüne göre ayarlanmış uzman karakterler:
 
-Türk kültürüne özel eğitilmiş **9 uzman karakter** — `@` ile çağrılır:
+| Karakter | Alan |
+|---|---|
+| 👵 **@FatmaAna** | Yemek, ev ekonomisi, gündelik hayat |
+| 🌿 **@LokmanHekim** | Sağlıklı yaşam sohbetleri |
+| 🎓 **@Üstat** | Bilgelik, öğretmenlik |
+| 🕌 **@HaciBayramHoca** | Manevi ve dini sorular |
+| 🧾 **@MuhasebeciYunus** | Vergi, KDV, SGK, e-fatura, beyanname |
+| ⚖️ **@Avukat** | Hukuki konular |
+| 💻 **@Kod** (Kod Ustası) | Yazılım |
 
-`@FatmaAna` · `@Üstat` · `@LokmanHekim` · `@HaciBayramHoca` · `@Kod` · …
+Ayrıntılar ve kullanım örnekleri: [Karakter sistemi](urunler/08-karakterler.md)
 
-> *"FatmaAna karakteri müthiş! Annem bile kullanıyor artık. Yemek tariflerinden ev ekonomisine kadar her şeyi soruyor."* — Bireysel kullanıcı
+## 👩‍💻 Geliştiriciler için
 
-## 💳 Planlar
+```bash
+# Numex CLI
+npm install -g @numexai/cli
+numex basla                        # giriş + menü
+numex "React e-ticaret arayüzü oluştur"
+numex plan "ödeme modülü ekle"     # sadece plan, kod değişikliği yok
+numex mission "testleri yeşile çek" # uzun süreli otonom misyon
+numex undo                          # son turu geri al
+```
 
-KDV dahil, şeffaf fiyatlandırma. Yıllık ödemede **2 ay bedava**.
+```javascript
+// Numex Codex SDK
+const { Numex } = require('numexcodex-sdk');
+const numex = new Numex({ apiKey: process.env.NUMEX_API_KEY });
+const r = await numex.chat.completions.create({
+  messages: [{ role: 'user', content: 'Merhaba' }]
+});
+```
 
-| Plan | Fiyat | Mesaj | Bağlam | Öne çıkanlar |
+```bash
+# REST API — Base: https://www.numexai.com.tr/api/v1
+curl -X POST https://www.numexai.com.tr/api/v1/chat \
+  -H "Authorization: Bearer nx_live_ANAHTARINIZ" \
+  -H "Content-Type: application/json" \
+  -d '{"message":"Merhaba","history":[]}'
+```
+
+→ [CLI](urunler/02-numex-cli.md) · [Codex IDE](urunler/03-numex-codex-ide.md) · [Core](urunler/04-numex-core.md) · [API & SDK](urunler/05-api-ve-sdk.md) · [Hub & Forge](urunler/06-hub-ve-forge.md)
+
+## 💳 Planlar ve fiyatlar
+
+KDV dahil, şeffaf. Yıllık ödemede **2 ay bedava**.
+
+| | 🆓 Ücretsiz | ⚡ Başlangıç PRO | 🚀 Numex PRO ⭐ | 💎 Advanced |
 |---|---|---|---|---|
-| 🆓 **Ücretsiz** | ₺0 | 15/gün | 8K | Numex Hızlı model, günde 3 web araması, temel CLI |
-| ⚡ **Başlangıç PRO** | ₺99/ay | 50/gün | 32K | Gelişmiş model, belge analizi, 3 karakter, tam CLI |
-| 🚀 **Numex PRO** ⭐ | ₺399/ay | Limitsiz | 128K | Öncelikli kuyruk, CLI + API, tüm karakterler, beta erişimi |
-| 💎 **Advanced** | ₺599/ay | Limitsiz | 128K | En yüksek öncelik, özel karakter, 3 alt hesap, WhatsApp destek |
+| **Fiyat** | ₺0 | ₺99/ay | ₺399/ay | ₺599/ay |
+| **Mesaj** | 15/gün | 50/gün premium | Limitsiz | Limitsiz (adil kullanım) |
+| **Bağlam** | 8K | 32K | 128K | 128K |
+| **Model** | Numex Hızlı | Numex Gelişmiş | Gelişmiş · öncelikli kuyruk | Gelişmiş · en yüksek öncelik |
+| **Web arama** | 3/gün | 50/ay | Limitsiz | Limitsiz |
+| **CLI / API** | Temel CLI | Tam CLI | CLI + API | Tam CLI + tam API |
+| **Dosya & belge** | — | 5 dosya · 50 sayfa/ay | Limitsiz | Limitsiz |
+| **Karakterler** | — | 3 | Tümü | Tümü + özel karakter |
+| **Sohbet geçmişi** | Son 5 | Son 30 | Limitsiz | Limitsiz |
+| **Ekstra** | — | — | Beta erişimi | 3 alt hesap · WhatsApp destek |
 
-**Numex Kredisi** (12 ay geçerli): Mini ₺25 · Standart ₺75 · Büyük ₺175 · Mega ₺450
-**Zaman bazlı bilet** (otomatik yenilenmez): Gece 8 sa ₺29 · Günlük ₺49 · Sprint 72 sa ₺99 · Haftalık ₺169
+**💳 Numex Kredisi** (12 ay geçerli) — Mini ₺25 (~60 mesaj) · Standart ₺75 (~200) · Büyük ₺175 (~500) · Mega ₺450 (~1400)
+**⏱ Zaman bazlı bilet** (otomatik yenilenmez, PRO erişimi) — 🌙 Gece 8 sa ₺29 · ☀️ Günlük ₺49 · ⚡ Sprint 72 sa ₺99 · 🚀 Haftalık ₺169
+**🎁 Misafir kullanım** — kayıt olmadan günde 5 mesaj.
 
-Ödemeler İyzico altyapısıyla; kart bilgileri Numex sunucularında saklanmaz.
+Ödeme: kredi/banka kartı, QR kod · İyzico altyapısı · 256-bit SSL · kart bilgisi Numex'te saklanmaz.
 *Güncel fiyatlar için [numexai.com.tr](https://numexai.com.tr) esastır.*
 
-## 🔒 Gizlilik ve altyapı
+## 🔒 Güvenlik, gizlilik ve altyapı
 
-- 🇹🇷 **Veriler Türkiye'de:** İşleme ve saklama Türkiye sınırları içinde, **KVKK** standartlarına uygun.
-- 🖥️ **Çift sunucu mimarisi:** Her biri 256 GB RAM'li iki sunucu; biri devre dışı kalırsa diğeri devralır.
-- 🔍 **Şeffaflık:** Detective Mode ve DeepView ile karar süreci izlenebilir.
-- ✅ **Kontrol sizde:** Agent modu değişiklikleri diff olarak sunar; onayınız olmadan uygulanmaz.
+- 🇹🇷 Veriler **Türkiye sınırları içinde** işlenir ve saklanır; **KVKK** uyumlu.
+- 🖥️ **Çift sunucu mimarisi** — her biri 256 GB RAM; biri düşerse diğeri devralır. SAS + NAS depolama.
+- ☁️ Altyapı sağlayıcıları: Google Cloud, Microsoft Azure, Anthropic, Vercel, Meta, MongoDB, DeepSeek — veri işleme Numex politikasına tabidir.
+- 🔐 Google & GitHub OAuth, JWT oturumları, üretimde zayıf anahtar reddi.
+- ✅ Agent/otonom modlarda **onay kapısı**, diff önizleme, geri alma (`numex undo`, PC Doktoru rollback).
+- ♿ Erişilebilirlik: yüksek kontrast, büyük yazı, ekran okuyucu desteği.
+
+→ [Güvenlik ve KVKK](urunler/12-guvenlik-kvkk.md)
 
 ## 🏔️ Hikaye
 
 | Yıl | Kilometre taşı |
 |---|---|
 | **2021** | *Bir soru ile başlangıç.* İlk satırlar Panorama İstanbul fotoğraf stüdyosunun arka odasında yazıldı. |
-| **2023** | **Pipeline Motoru** — her yanıtı Türkçe'ye özel katmanlardan geçiren çok aşamalı işleme. |
+| **2023** | **Pipeline Motoru** — ham AI çıktısını Türkçe'ye özel katmanlardan geçiren çok aşamalı işleme. |
 | **2024** | **Detective Mode™** — çoklu model tartışma ve hakem sistemi. |
-| **2025** | **Tam ekosistem** — sohbet, kod, belge analizi, sesli konuşma ve 9 Türkçe karakter. |
-| **2026** | **PusulamX** ve **PC Doktoru Süper Ajan** — işletmeler ve Windows kullanıcıları için Numex gücü. |
+| **2025** | **v3.0** — sıfırdan yeniden yazım: Pipeline, karakterler, planlar, Dış API (`/v1/chat/completions`), admin paneli, çift sunucu. **DeepView™ v1.0** (Mart). |
+| **2026 Şubat** | **v3.1** — ilk genel kullanıcı sürümü: Pro/Fast/Vision/Code, paylaşılabilir sohbetler, misafir kullanım, OAuth, Codex editörü. |
+| **2026** | **Numex Ailesi**: Codex IDE v2.9.59 & CLI v3.3.10, Okul, Market (44 uygulama), Numexpedia, Hub & Forge, Oyun Bahçesi; aynı ekipten **Pusulam** ve **PC Doktoru v3.1**. |
 
-**Kurucu:** Nurullah Şahin — Kurucu & AI Mimarı. Sivas Gürün kökenli, İstanbul'da yaşayan teknoloji girişimcisi.
+**Kurucu — Nurullah Şahin** · Kurucu & AI Mimarı. Sivas Gürün kökenli, İstanbul'da yaşayan teknoloji
+girişimcisi; 2010'dan bu yana yapay zeka ve makine öğrenmesi alanında çalışıyor. Panorama Istanbul
+Fotoğrafçılık'ın kurucusu.
 
 > *"Yapay zeka insanı desteklemeli, yerini almamalı. Anadolu'nun bilgeliğiyle İstanbul'un dinamizmini
-> harmanlayarak, herkes için anlaşılır ve faydalı bir yapay zeka inşa ediyoruz."*
+> harmanlayarak, herkes için anlaşılır ve faydalı bir yapay zeka inşa ediyoruz."* — Nurullah Şahin
 
-**Değerlerimiz:** 🌱 Erişilebilirlik · 🔍 Şeffaflık · 🤝 İnsan merkezli · 🏔️ Kültürel bağlam · 🔒 Gizlilik · 🌿 Sürdürülebilirlik
+## 🌱 Değerler
 
-## 📚 Makaleler
+| | | |
+|---|---|---|
+| 🌱 **Erişilebilirlik** — AI herkesin aracı olmalı | 🔍 **Şeffaflık** — karar süreci izlenebilir | 🤝 **İnsan merkezli** — teknoloji insana hizmet eder |
+| 🏔️ **Kültürel bağlam** — Türkçe bir dünya görüşüdür | 🔒 **Gizlilik** — veriler Türkiye'de | 🌿 **Sürdürülebilirlik** — verimli sunucular, optimize çağrılar |
 
-| # | Makale |
-|---|---|
-| 1 | [Numex AI: Türkçe düşünen yapay zeka](makaleler/01-numex-ai-tanitim.md) |
-| 2 | [Pipeline, Detective Mode™ ve Multi-Agent nasıl çalışır?](makaleler/02-pipeline-detective-multi-agent.md) |
-| 3 | [Geliştiriciler için Numex: CLI, Codex IDE, Agent ve Süper SDK](makaleler/03-gelistiriciler-icin-numex.md) |
-| 4 | [Veri Türkiye'de kalır: KVKK ve Numex altyapısı](makaleler/04-kvkk-ve-altyapi.md) |
-| 5 | [Numex ekosistemi: PC Doktoru, PusulamX ve ötesi](makaleler/05-numex-ekosistemi.md) |
+## 📚 Dokümanlar ve makaleler
+
+**Ürün sayfaları** — [`urunler/`](urunler/)
+**Teknik** — [Mimari](docs/mimari.md) · [Yol haritası & sürüm notları](docs/yol-haritasi.md) · [SSS](docs/sss.md) · [Sözlük](docs/sozluk.md)
+**Makaleler** — [`makaleler/`](makaleler/)
+
+1. [Numex AI: Türkçe düşünen yapay zeka](makaleler/01-numex-ai-tanitim.md)
+2. [Pipeline, Detective Mode™ ve Multi-Agent nasıl çalışır?](makaleler/02-pipeline-detective-multi-agent.md)
+3. [Geliştiriciler için Numex](makaleler/03-gelistiriciler-icin-numex.md)
+4. [Veri Türkiye'de kalır: KVKK ve altyapı](makaleler/04-kvkk-ve-altyapi.md)
+5. [Numex ekosistemi: PC Doktoru, PusulamX ve ötesi](makaleler/05-numex-ekosistemi.md)
 
 ## 🤝 Katkı
 
 Bu depo Numex AI'ın **açık tanıtım ve dokümantasyon** deposudur. Yazım düzeltmeleri, çeviriler,
-kullanım örnekleri ve yeni makaleler için Pull Request açabilirsiniz. Hata ve önerileriniz için
-[Issues](../../issues) sekmesini kullanın.
+kullanım örnekleri ve yeni makaleler için Pull Request açabilirsiniz. Soru ve önerileriniz için
+[Issues](../../issues).
 
 ## 📬 İletişim
 
-- 🌐 [numexai.com.tr](https://numexai.com.tr)
-- 📧 destek@numexai.com.tr
-- 📸 [Instagram](https://instagram.com/numexai) · 💼 [LinkedIn](https://linkedin.com/company/numexai) · 🐦 [X / Twitter](https://twitter.com/numexai)
+🌐 [numexai.com.tr](https://numexai.com.tr) · 📧 destek@numexai.com.tr ·
+📸 [Instagram](https://instagram.com/numexai) · 💼 [LinkedIn](https://linkedin.com/company/numexai) · 🐦 [X](https://twitter.com/numexai)
 
 <div align="center">
 
 ---
 
 **◆ Numex AI** — Dünya devleriyle inşa ettik. Anadolu için yoğurduk.<br>
-🇹🇷 İstanbul'da geliştirildi
+🇹🇷 İstanbul'da geliştirildi · MIT
 
 </div>

docs/mimari.md

@@ -0,0 +1,80 @@
+# 🏗️ Numex Mimarisi
+
+## Katmanlar
+
+```mermaid
+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) |

docs/sozluk.md

@@ -0,0 +1,34 @@
+# 📘 Numex Sözlüğü
+
+| Terim | Anlam |
+|---|---|
+| **Core — Beyin** | Tüm Numex ürünlerinin arkasındaki otonom ajan motoru (`@numex-ai/core`) |
+| **Pipeline (Boru Sistemi)** | Her isteğin geçtiği 5 aşamalı işleme hattı: Boru 1, AI Motor, Boru 2A, Boru 2B, yanıt |
+| **Boru 1** | Prompt güçlendirme, bağlam ekleme |
+| **Boru 2A** | Türkçe düzeltme, format ve ton |
+| **Boru 2B** | Kalite kontrol ve doğrulama |
+| **Detective Mode™ (Dedektif Modu)** | Aynı soruyu birden çok modele çözdürüp hakemin en iyi cevabı gerekçesiyle seçmesi |
+| **Hakem Sistemi** | Detective Mode ve Multi-Agent'ta çıktıları değerlendiren katman |
+| **Multi-Agent** | Görevi alt görevlere bölüp uzman ajanlara dağıtan orkestratör mimarisi |
+| **DeepView™** | Çoklu uzman orkestratörü ve AI düşüncesinin 6 katmanlı görselleştirmesi |
+| **Master Plan** | DeepView'in ürettiği tek entegre belge |
+| **Swarm Council** | Mimar, Kodlayıcı, Denetçi, Tasarımcı'dan oluşan 4'lü ajan konseyi |
+| **FinishGate** | "Bitti" demeden önce canlı kanıt (HTTP 200, test, DOM) isteyen kapı |
+| **Self-Healing Loop** | 3 turluk otonom hata bulma ve düzeltme döngüsü |
+| **Omni-Vision** | Headless Chrome ile DOM ve 3D Canvas'ı görsel denetleme |
+| **Self-Evolving Memory** | Çözümleri `.agents/skills/` altında öğrenen hafıza |
+| **`.numex/`** | Projedeki ajan hafızası: RAG indeksi, denetim izi, checkpoint'ler, misyon durumu |
+| **NCP** | Blender, Unity, Figma gibi araçlar için Numex eklenti protokolü |
+| **Numex Çözüm** | Codex IDE içindeki asistanın adı |
+| **Hata Avcısı** | Codex'te hata kök nedenini bulan mod |
+| **Misyon (`numex mission`)** | İzole çalışma alanlarında uzun süreli otonom görev |
+| **Uzaktan CLI** | Tarayıcıdan/telefondan kendi PC'nize komut gönderme köprüsü |
+| **Profil** | Numex Pro, Fast, Vision, Code — işe göre model yönlendirmesi |
+| **Karakter** | `@FatmaAna`, `@MuhasebeciYunus` gibi kültüre özgü uzman kişilikler |
+| **Numex Kredisi** | Abonelik dışı, 12 ay geçerli kullandıkça öde paketleri |
+| **Zaman bileti (Time-Pass)** | 8 saat–7 gün süreli, otomatik yenilenmeyen PRO erişimi |
+| **`nx_live_`** | Numex API anahtarı öneki |
+| **Forge** | Gitea tabanlı Numex Git sunucusu |
+| **Hub** | Forge üzerinde AI destekli depo yönetimi ve topluluk vitrini |
+| **Çatalla** | Fork — bir depoyu kendi hesabına kopyalayıp geliştirmek |
+| **Selçuklu yıldızı** | 180° çevrilen Numex logosunda ortaya çıkan 8 köşeli yıldız |

docs/sss.md

@@ -0,0 +1,52 @@
+# ❓ Sıkça Sorulan Sorular
+
+### Numex nedir?
+İnsanı önce koyan Türk yapay zekâsı. Sohbet asistanından kod ajanına, eğitimden hazır uygulamalara
+uzanan, tek bir **Core — Beyin** üzerinde çalışan ürün ailesi. → [Numex Ailesi](../urunler/15-numex-ailesi.md)
+
+### Ücretsiz mi?
+Evet, başlayabilirsiniz: Ücretsiz plan günde 15 mesaj; kayıtsız misafir kullanımı günde 5 mesaj.
+**Market**, **Numexpedia** ve **Oyun Bahçesi** tamamen ücretsizdir. Ücretli planlar ₺99/ay'dan başlar.
+
+### Verilerim nerede?
+Türkiye'de, KVKK uyumlu altyapıda. Codex ve CLI'de ajan dosyalarınızı kendi bilgisayarınızda işler.
+→ [Güvenlik](../urunler/12-guvenlik-kvkk.md)
+
+### Hangi modeller kullanılıyor?
+Numex; Google Cloud, Microsoft Azure, Anthropic, Meta ve DeepSeek gibi sağlayıcıların altyapısını
+kendi **Pipeline**, **Detective Mode** ve **Multi-Agent** sistemleriyle sarar. Arayüzde Numex Pro,
+Fast, Vision ve Code profillerini görürsünüz.
+
+### Codex, CLI ve IDE arasındaki fark ne?
+Hepsi aynı çekirdek. **Codex Web** tarayıcıda kurulumsuz; **Codex IDE** masaüstü editör (VS Code
+tabanlı); **CLI** terminal ve otomasyon için. → [Codex](../urunler/03-numex-codex-ide.md)
+
+### Ajan bilgisayarımda izinsiz bir şey yapar mı?
+Hayır. Plan sunar, onay ister, değişiklikleri diff olarak gösterir; her işlem `.numex/audit`'e yazılır
+ve `numex undo` ile geri alınabilir. "YOLO" (onaysız) modu yalnızca siz açarsanız çalışır.
+
+### İnternetsiz çalışır mı?
+CLI `--offline` ile yerel Ollama modeliyle; Core'un ONNX WASM katmanı tamamen yereldir. PC Doktoru
+teşhis ve bakımda offline çalışır.
+
+### Okul'daki sorular doğru mu?
+Her soruyu bir AI hazırlar, ikinci AI bağımsız çözer; cevaplar uyuşmazsa soru elenir ve yenisi
+üretilir. → [Numex Okul](../urunler/11-numex-okul.md)
+
+### Market'teki uygulamaları ticari projede kullanabilir miyim?
+Uygulamalar açık kaynaktır; her deponun lisansı Forge'daki sayfasında yazar.
+
+### Time-Pass (zaman bileti) otomatik yenilenir mi?
+Hayır. Süre bitince ücret kesilmez.
+
+### Bağlam penceresi (context) nedir?
+Yapay zekanın bir sohbette aynı anda hatırlayabildiği metin miktarı. 128K bağlam, 300+ sayfalık
+belge ya da uzun kod tabanlarıyla çalışabilmek demektir.
+
+### API'ye nasıl başlarım?
+numexai.com.tr → API → **Ücretsiz API Anahtarı Al**; ilk kayıtta 100.000 token hediye.
+→ [API & SDK](../urunler/05-api-ve-sdk.md)
+
+### Logodaki yıldız ne anlama geliyor?
+180° çevrildiğinde Selçuklu mimarisinin 8 köşeli yıldızı olur: *"İki kimlik, tek sembol."*
+→ [Marka kimliği](../urunler/17-marka-kimligi.md)

docs/yol-haritasi.md

@@ -0,0 +1,48 @@
+# 🗺️ Yol Haritası ve Sürüm Notları
+
+## Zaman çizelgesi
+
+| Dönem | Sürüm | Öne çıkanlar |
+|---|---|---|
+| 2021 | — | Fikir: *"Türkçe konuşan, Türk kültürünü anlayan bir yapay zeka neden yok?"* |
+| 2023–2024 | v2.x | İlk prototip → üretim; ilk Pipeline prototipi (prompt güçlendirme), temel sohbet ve kullanıcı sistemi, Detective Mode konsepti |
+| 2025 | **v3.0** | Sıfırdan yeniden yazım: Türkçe odaklı altyapı, Pipeline (Boru Sistemi), sohbet + kod + belge analizi, karakter sistemi, KVKK uyumlu işleme, planlar (Free/Basic/Pro/Advanced/Kurumsal), Dış API (`/v1/chat/completions`), admin paneli, çift sunucu, çoklu sağlayıcı, Serper web arama |
+| Mart 2025 | DeepView v1.0 | Çoklu uzman orkestratörü, 6 katmanlı görselleştirme |
+| Şubat 2026 | **v3.1** | İlk genel kullanıcı sürümü (aşağıda) |
+| 2026 | Aile | Codex IDE v2.9.59, CLI v3.3.10, Okul, Market, Numexpedia, Hub & Forge, Oyun Bahçesi, Pusulam, PC Doktoru v3.1 |
+
+## v3.1 — Şubat 2026
+
+**✦ Yeni özellikler**
+- Numex **Pro, Fast, Vision ve Code** profilleri — Pipeline ile güçlendirilmiş 4 model
+- Web arama modu (chip seçiciler)
+- Paylaşılabilir sohbet linkleri
+- Uygulama içi bildirim sistemi
+- Misafir kullanımı — kayıt olmadan günde 5 mesaj
+- Google ve GitHub OAuth girişi
+- Codex — gelişmiş kod editörü ve syntax highlighting
+- Web cache — daha hızlı açılış
+
+**↑ İyileştirmeler**
+- Boru 2A — Türkçe çıktı kalitesi **%30** iyileşti
+- Sohbet arayüzü yeniden tasarlandı
+- Karakterler daha doğal yanıt veriyor
+- API ortalama yanıt süresi **0,8 s → 0,5 s**
+- Erişilebilirlik: yüksek kontrast, büyük yazı, ekran okuyucu
+
+**⚑ Düzeltmeler**
+- Uzun sohbetlerde bellek sızıntısı
+- Mobilde klavye açılınca giriş alanının kayması
+- Markdown kod bloklarının kırılması
+
+## Numex Core seviyeleri
+
+| Seviye | Durum |
+|---|---|
+| 1 — CLI | ✅ |
+| 2 — Chat + Tools | ✅ |
+| 3 — RAG + Context | ✅ |
+| 4 — Otonom kodlama (scaffold, E2E deploy) | ✅ |
+| 5 — Swarm Council | ✅ |
+| 6 — Sentetik Mimar (meta-reasoning, 12 sektör, öz-eğitim) | ✅ geliştirme ortamında |
+| 7–8 | Vizyon aşamasında |

urunler/01-numex-ai-platform.md

@@ -0,0 +1,68 @@
+# 🌐 Numex AI Platform — Web & PWA
+
+**Türkçe sohbet, kod, görsel, ses, belge analizi ve web araması — tek arayüzde.**
+🔗 [numexai.com.tr](https://numexai.com.tr)
+
+![Numex AI web sohbet](../gorseller/web-sohbet.png)
+*"Merhaba, ben Numex AI — Türkçe odaklı çalışma arkadaşınız: kod, araştırma ve belge analizi." `@` ile uzman/karakter seçimi, hızlı başla önerileri, Numex Auto model seçici, sesli giriş.*
+
+## Ne yapar?
+
+| Yetenek | Açıklama |
+|---|---|
+| 💬 **Türkçe sohbet** | Pipeline'dan geçen, doğal ve günlük Türkçe yanıtlar. |
+| 💻 **Kod** | Kod yazma, açıklama, debug; canlı önizlemeli **Canvas** alanı ve syntax highlighting'li Codex editörü. |
+| 📄 **Belge analizi** | PDF ve Word dosyalarını özetleme, soru sorma, karşılaştırma. |
+| 🌐 **Web arama modu** | Güncel bilgiyi arayıp kaynaklı özet; chip seçicilerle mod değişimi. |
+| 👁️ **Görsel anlama** | Numex Vision profiliyle görsel analiz ve açıklama. |
+| 🎙️ **Sesli giriş & konuşma** | Sesli komut ve sesli sohbet oturumları. |
+| 🇹🇷 **Karakterler** | `@FatmaAna`, `@LokmanHekim`, `@MuhasebeciYunus`… ([ayrıntı](08-karakterler.md)) |
+| 🕵️ **Detective Mode™** | Kritik sorularda çoklu model + hakem. |
+| 🔬 **DeepView™** | Çoklu uzmanla "Master Plan" ve 6 katmanlı düşünce görünümü. |
+| 🤖 **Agent modu** | Çok adımlı görevleri planlar, değişiklikleri diff olarak sunar. |
+| 🔗 **Paylaşılabilir sohbetler** | Sohbet linkini başkalarıyla paylaşın. |
+| 🔔 **Bildirimler** | Uygulama içi güncelleme ve duyurular. |
+
+## Deneyim
+
+- **Kayıt olmadan dene:** Misafir olarak günde 5 mesaj.
+- **Tek tıkla giriş:** Google veya GitHub OAuth.
+- **PWA:** Giriş yaptıktan sonra telefon veya masaüstüne uygulama olarak ekleyin.
+- **Temalar:** Lacivert (varsayılan), Açık, Açık Sade, Sistem.
+- **Erişilebilirlik:** Yüksek kontrast, büyük yazı, ekran okuyucu desteği.
+- **Mobil öncelikli** tasarım; klavye açıldığında kayma gibi mobil sorunlar v3.1'de giderildi.
+
+## Profiller
+
+![Numex profilleri ve agent sistemi](../gorseller/profiller.png)
+
+![Profil akışı: Kullanıcı → Router → Numex Sunucu → Pro/Fast/Code](../gorseller/profil-akisi.png)
+
+| Profil | Ne zaman? |
+|---|---|
+| 🧠 **Numex Pro** | Uzun bağlam (128K), derin analiz, karmaşık görevler |
+| ⚡ **Numex Fast** | Hızlı sohbet, kısa görevler |
+| 👁️ **Numex Vision** | Görsellerle çalışma |
+| 💻 **Numex Code** | Debug, refactor, test, dokümantasyon |
+
+Arayüzdeki profil, planınıza göre sunucu katmanında uygun işlem hattına otomatik yönlendirilir.
+
+## Örnek kullanımlar
+
+- *"Bu sözleşmedeki fesih maddelerini özetle"* → belge analizi
+- *"@MuhasebeciYunus şahıs şirketinde KDV beyannamesi ne zaman verilir?"*
+- *"@FatmaAna 4 kişilik, bütçe dostu bir akşam menüsü"*
+- *"React componentimde neden memory leak oluşuyor?"* → Detective Mode
+- *"@Backend @DevOps @Security bu SaaS için entegre taslak çıkar"* → DeepView Master Plan
+
+## Agent modu
+
+![Numex Agent — sizin yerinize kodlar](../gorseller/agent-modu.png)
+![Agent diff görünümü](../gorseller/agent-diff.png)
+
+## Planlar
+
+![Planlar](../gorseller/planlar-kartlar.png)
+![Kredi ve zaman bazlı biletler](../gorseller/planlar-kredi-bilet.png)
+Ücretsiz (₺0) · Başlangıç PRO (₺99) · Numex PRO (₺399) · Advanced (₺599) + kredi paketleri ve
+zaman bazlı biletler. → [Ana sayfadaki plan tablosu](../README.md#-planlar-ve-fiyatlar)

urunler/02-numex-cli.md

@@ -0,0 +1,85 @@
+# ⌨️ Numex CLI
+
+**Terminal ve IDE'ler için Türkçe, otonom, ajan tabanlı kodlama asistanı.**
+Lisans: MIT · Paket: `@numexai/cli`
+
+![Numex Codex CLI açılış ekranı](../gorseller/cli-codex-acilis.png)
+*`numex` → Terminal sohbeti: Selçuklu yıldızı logosu, sunucu, proje kökü, sürüm, mod ve model bilgisi.*
+
+## Kurulum
+
+```bash
+# npm (Node.js 18+)
+npm install -g @numexai/cli
+
+# Windows tek satır (PowerShell)
+irm https://www.numexai.com.tr/install-cli.ps1 | iex
+
+numex --version
+numex basla     # tarayıcıda giriş + başlangıç menüsü
+```
+
+![CLI kurulum sayfası](../gorseller/cli-sayfa.png)
+
+## Temel komutlar
+
+| Komut | Ne yapar? |
+|---|---|
+| `numex` | Etkileşimli REPL (terminal sohbeti) |
+| `numex basla` | Giriş + menü |
+| `numex login` | Hesaba giriş |
+| `numex "<görev>"` | Tek seferlik görev: `numex "React e-ticaret arayüzü oluştur"` |
+| `numex plan "<görev>"` | **Mimar planlayıcı** — kod değiştirmeden plan üretir |
+| `numex mission "<görev>"` | **Uzun süreli otonom misyon** — izole sandbox worktree'lerde |
+| `numex undo` | Son turu tek tıkla geri al |
+| `numex --offline "<görev>"` | Yerel Ollama ile çevrimdışı mod |
+| `numex --api-key nx_live_…` | API anahtarı ayarla |
+| `numex --devam` | Son oturumdan devam |
+| `/model fast \| pro \| code` | Aktif profili kilitle |
+
+## Uzaktan PC köprüsü
+
+Telefonunuzdan veya başka bir cihazdan **kendi bilgisayarınıza** klasör oluşturun, dosya yazın,
+komut çalıştırın.
+
+```bash
+numex uzak             # köprüyü başlat (terminal açık kalsın)
+numex uzak install     # arka plan servisi — terminal kapansa da çalışır, sistem tepsisinde ikon
+numex uzak pause       # duraklat
+```
+
+![numex menüsü](../gorseller/cli-menu.png)
+
+![Uzaktan CLI — PC bağlandı](../gorseller/uzak-cli-baglandi.png)
+
+![Tarayıcıdan PC'ye komut gönderme sayfası](../gorseller/uzak-cli-web.png)
+
+Ardından web'deki **developers/remote** sayfasından yazın. Bağlantıda cihaz ID'si ve sohbet linki
+terminalde görünür.
+
+## Öne çıkan mühendislik
+
+| Özellik | Açıklama |
+|---|---|
+| ✂️ **Surgical Fast-Patching** | Unified diff hunk ve satır aralığı çapalarıyla cerrahi kod değişiklikleri — dosyanın tamamını yeniden yazmaz. |
+| 🛰️ **Live Subshell Intercept** | Arka plandaki node/vite/npm süreç hatalarını ~2 saniyede yakalar ve kendini toparlar. |
+| 🌳 **Tree-View Live Progress** | Görev adımlarını canlı ağaç görünümünde gösterir. |
+| 🚦 **FinishGate** | Görev "bitti" sayılmadan önce **canlı kanıt** ister: HTTP 200, birim testleri, DOM kontrolleri. |
+| 🔎 **RAG kod indeksleme** | BM25 + AST grafiğiyle kod tabanında anlamlı arama. |
+| 🔌 **MCP istemcisi** | Model Context Protocol ile dosya sistemi ve git araçları (`mcp.json`). |
+| 🧑‍🤝‍🧑 **İnsan-yoldaş modu** | "Önce anlaşalım, sonra yapalım": otonom modda bile onay alır. |
+| 🧾 **Denetim izi & checkpoint** | Her tur kaydedilir; geri alınabilir. |
+| 🔀 **Git entegrasyonu** | Commit, PR açma, issue → PR hattı. |
+
+## Kişilik
+
+Numex Codex'in kişilik tanımı: *"Önce insan, sonra iş yapan."* Kullanıcıyı dinler, "şunu mu demiştin?"
+diye sorar, yol haritasını birlikte çizer, hata yaparsa kabul edip yol gösterir. Kullanıcının
+ruh halini (stres, yorgunluk, heyecan) fark edip tempo ayarlar.
+
+## Kimler için?
+
+- Terminalde yaşayan geliştiriciler
+- Türkçe açıklama ve Türkçe kod yorumu isteyen ekipler
+- Bilgisayarına uzaktan (telefondan) iş yaptırmak isteyenler
+- CI/CD ve otomasyon hatlarına ajan eklemek isteyenler ([SDK](05-api-ve-sdk.md))

urunler/03-numex-codex-ide.md

@@ -0,0 +1,267 @@
+# 🧩 Numex Codex — Web, IDE ve CLI
+
+🔗 **[codex.numexai.com.tr](https://codex.numexai.com.tr)** · IDE **v2.9.59** · CLI **v3.3.10**
+
+> **TÜRKÇE KOD AJANI — Editörüne Türkçe düşünen bir kod ajanı.**
+> Türkçe konuşan AI kod editörü. Hazır masaüstü uygulaması, VS Code eklentisi veya komut satırı —
+> sana uyanı seç. **İste, yazsın, çalıştırsın — iş bitene kadar.**
+
+| İndir | Komut | Boyut |
+|---|---|---|
+| ⬇️ **Masaüstüne indir · Windows** (Numex Codex IDE v2.9.59) | `npm i -g @numexai/cli` | ~162 MB · tamamen Türkçe |
+
+```console
+$ numex login
+✓ Giriş başarılı — hoş geldin 👋
+$ numex
+◇ Numex Codex — Türkçe kod ajanı hazır
+```
+
+Editör içindeki asistanın adı **Numex Çözüm**'dür.
+
+![Numex Codex IDE — ayarlar paneli, proje ağacı ve Swarm fazında çalışan ajan](../gorseller/codex-ide-ayarlar-swarm.png)
+*Solda proje ağacı, ortada Numex Ayarları → Token Kullanımı, sağda Numex Çözüm paneli: ajan hatayı
+teşhis ediyor, "SWARM FAZI · Kabul · Denetim" aşamasında plan çıkarıp komutu çalıştırıyor.*
+
+
+## 🌐 Codex'in üç hali
+
+Numex Codex, aynı **Numex Çekirdeği**'ne üç farklı kapıdan erişir:
+
+| | Nerede? | Kurulum | Kimin için? |
+|---|---|---|---|
+| 🌐 **Codex Web** | Tarayıcıda | Yok | "Sohbet eder gibi" hızlı proje üretmek ve yayınlamak isteyenler |
+| 🧩 **Codex IDE / VS Code eklentisi** | Masaüstü | IDE indir ya da eklenti kur | Profesyonel geliştiriciler |
+| ⌨️ **Codex CLI** | Terminal | `npm i -g @numexai/cli` | Terminal, otomasyon, uzak PC ([ayrıntı](02-numex-cli.md)) |
+
+### Codex Web — tarayıcıda editör
+
+![Numex Codex Rehberi](../gorseller/codex-rehber.png)
+
+> *"Chat kutusuna ne istediğini yaz. Agent dosyaları otomatik oluşturur, editöre yazar, önizlemeyi
+> günceller. Tek buton yok, tek tıklama yok — sadece yaz ve izle."*
+
+- **Düzen:** Solda dosya gezgini + **Monaco** editörü, sağda AI ajan sohbeti, altta terminal, ayrı
+  **önizleme** sekmesi.
+- **Farkı:** Normal sohbette AI kod yazar, siz kopyalarsınız; Codex'te AI **dosyaları doğrudan editöre yazar**.
+- **Nasıl çalışır:** ① İsteği Türkçe yaz → ② Ajan adım adım araç kullanır (*📝 Yazıyor: index.html ·
+  ✅ Tamamlandı*) → ③ Dosyalar editöre yazılır, önizleme güncellenir → ④ *"navbar rengini değiştir"*
+  diye konuşarak geliştirmeye devam.
+- **Şablonlar:** Başlangıç · Boş · Todo · Hesap · Dashboard · E-ticaret · Blog · Manav.
+- **Hedef platform** (Web / API-Backend / Masaüstü) ve **proje türü** (Muhasebe, Satış/POS, Oyun,
+  E-ticaret, Blog, Kurumsal Panel…) seçimi — ajan buna göre mimari kurar.
+- **Kod araçları:** 🧠 Kodu analiz et · ⚡ Performans optimizasyonu · 💬 JSDoc yorumları · 🔧 Hata bul & düzelt.
+- **Ajan değişiklik kartı:** *"Agent — dosyayı düzenledi +N −M"* → **Kabul Et / Fark / Reddet**;
+  isteğe bağlı *otomatik kabul (5 sn)*.
+- **Proje:** Kaydet, ZIP indir, URL'den aç, proje yükle, **🚀 Yayınla** — proje tek tıkla herkese
+  açık bir adreste yayınlanır.
+- **Menüler:** Dosya · Düzenle · Gezgin · Görünüm (komut paleti `Ctrl+K`, önizleme, terminal, sohbet,
+  tam ekran) · Terminal (sunucuyu başlat/durdur) · Yardım (`.numex` kuralları, kısayollar).
+- **Örnek istekler:** *"profesyonel hesap makinesi yap"* · *"koyu temalı blog sitesi yap"* ·
+  *"todo app yap — localStorage kullansın"* · *"Node.js REST API oluştur"* · *"Python ile web scraper yaz"*.
+
+---
+
+## 📑 İçindekiler
+1. [Ekran düzeni](#-ekran-düzeni)
+2. [Dört çalışma modu: Sohbet · Plan · Otonom · Hata Avcısı](#-dört-çalışma-modu)
+3. [Kod yazarken](#️-kod-yazarken)
+4. [Kod tabanını anlama (RAG)](#-kod-tabanını-anlama)
+5. [Proje hafızası: `.numex/` klasörü](#-proje-hafızası-numex-klasörü)
+6. [Git ve kaynak denetimi](#-git-ve-kaynak-denetimi)
+7. [Terminal](#️-terminal)
+8. [Ajanlar: arka plan, bulut, tarayıcı, Design Mode](#-ajanlar)
+9. [Uzak geliştirme (SSH / WSL)](#-uzak-geliştirme)
+10. [Ayarlar paneli](#️-ayarlar-paneli)
+11. [Tüm komutlar](#-tüm-komutlar)
+12. [Kurulum](#-kurulum)
+13. [Bir günlük örnek akış](#-bir-günlük-örnek-akış)
+
+---
+
+## 🖥️ Ekran düzeni
+
+```
+┌───────────┬──────────────────────────────────┬────────────────────────────┐
+│ Gezgin /  │  Editör                          │  NUMEX │ AJANLAR           │
+│ Kaynak    │  ◆ Numex: <fonksiyon> hakkında   │  Numex Çözüm               │
+│ Denetimi  │    sor   ← Kod Lens               │  [Sohbet][Plan][Otonom]    │
+│           │  function ...                    │  [Hata Avcısı]   token ▣   │
+│ .numex/   │                                  │  ● Hazır                   │
+│  rag/     │                                  │  … ajan mesajları, adımlar │
+│  audit/   │                                  │  ┌──────────────────────┐  │
+│  …        │                                  │  │ @dosya  /komut       │  │
+│           │                                  │  │ + 📷 🎙 Ajan▾ Otomatik▾│ │
+├───────────┴──────────────────────────────────┴──┴──────────────────────┴──┤
+│ main* · Numex AI · 18 dosya indeksli                      Satır 1, Sütun 1 │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+- **Sağ panel — Numex Çözüm:** "Kod yazma, analiz ve ajan destekli geliştirme asistanınız."
+  Boş sohbette hızlı kartlar: **Projeyi tanı** (yapı ve ana dosyalar), **Görselden arayüz üret**
+  (ekran görüntüsü → çalışan kod), **Hata bul** (aktif dosyayı incele), **Testleri çalıştır** (sonuçları raporla).
+- **Bağlam çipleri:** Giriş kutusunun üstünde aktif dosya (ör. `public/app2.js`) ve çalışma klasörü
+  otomatik eklenir. `@` ile dosya, `/` ile komut çağrılır.
+- **Giriş çubuğu:** `+` ekle, 📷 ekran görüntüsü, 🎙 sesli giriş, **Ajan ▾** mod seçici,
+  **Otomatik ▾** model/onay seçici.
+- **Token göstergesi:** Oturumda kullanılan / kalan token (ör. `12418 / 817020`).
+- **Durum çubuğu:** Git dalı, Numex AI durumu ve **"N dosya indeksli"** bilgisi.
+- **Kod Lens:** Her fonksiyonun üstünde `◆ Numex: <ad> hakkında sor` bağlantısı.
+
+## 🔀 Dört çalışma modu
+
+| Mod | Ne yapar? | Ne zaman? |
+|---|---|---|
+| 💬 **Sohbet** | Soru-cevap; dosya okur, açıklar, öneri verir. | "Bu proje ne yapıyor?", "Bu fonksiyonu açıkla" |
+| 🗺️ **Plan** | Kod değiştirmeden mimari plan ve adım listesi çıkarır. | Büyük özellik öncesi yol haritası |
+| 🤖 **Otonom** | Plan → onay → uygula → doğrula döngüsünü kendisi yürütür; komut çalıştırır, dosya yazar. | "Testleri yeşile çek", "Ödeme modülünü ekle" |
+| 🐞 **Hata Avcısı** | Hata loglarını, terminal çıktısını ve kodu tarayıp kök nedeni bulur, düzeltme önerir. | "Uygulama açılıyor ama ses yok" |
+
+Ajan her adımı panelde gösterir: *"🔍 7 adım · 2 dosya okundu: router.js, db.json · 2 klasör tarandı ·
+63 eşleşme"*. Uzun görevlerde **Swarm fazları** (Plan → Kabul → Denetim) görünür; çalıştırılan her
+komut, çıkış koduyla birlikte kart olarak listelenir.
+
+**Örnek — "proje hakkında bilgi ver":** Ajan önce dosya ağacına ve `PROJECT_MAP`'e bakar, sonra
+projeyi amaç, teknik omurga (katman → dosya tablosu), API uçları ve iş mantığı başlıklarıyla
+Türkçe özetler.
+
+## ✍️ Kod yazarken
+
+| Özellik | Kısayol | Açıklama |
+|---|---|---|
+| **Satır içi düzenleme** | `Ctrl+K` | Seçili kodu doğal dille değiştir: *"bunu async yap"* |
+| **Sonraki düzenleme (Next Edit)** | `Tab` | Bir değişiklik yaptığınızda ilgili sonraki yeri tahmin eder; `Tab` ile uygula, kapatmak için reddet |
+| **Satır içi tamamlama** | — | Yazarken gri öneri |
+| **Kod Lens sorgusu** | tıkla | `◆ Numex: fonksiyon hakkında sor` |
+| **Seçimi sor** | `Ctrl+Alt+N` | Seçili kod bağlamıyla soru |
+| **Seçimi açıkla** | sağ tık | Türkçe açıklama |
+| **Dosyadaki hataları AI ile düzelt** | ampul menüsü | Tanılama hatalarını toplu düzelt |
+| **Composer** | komut | Çok dosyalı değişiklik taslağı |
+| **Hunk incelemesi** | — | Değişiklikleri parça parça kabul/ret |
+| **Diff sekmesi** | — | `Numex diff: main.py` gibi ayrı sekmede yan yana fark |
+
+## 🔎 Kod tabanını anlama
+
+- **Projeyi indeksle** — leksikal indeks (sembol, dosya özeti, bağımlılık grafiği).
+- **Anlamsal arama** — embedding indeksiyle *"ödeme nerede doğrulanıyor?"* gibi doğal dil araması.
+- **Kod tabanında ara** — komut paletinden.
+- **Tree-sitter** tabanlı sözdizimi ayrıştırma; CLI tarafında **BM25 + AST grafiği**.
+- Durum çubuğunda kaç dosyanın indekslendiği görünür.
+
+## 🧠 Proje hafızası: `.numex/` klasörü
+
+Numex her projede şeffaf bir `.numex/` klasörü tutar — ajanın ne bildiği ve ne yaptığı **sizin
+diskinizde, okunabilir dosyalarda** durur:
+
+| Dosya / klasör | İçerik |
+|---|---|
+| `rag/graph.json`, `rag/index.json`, `rag/symbols.json`, `rag/summary.md` | Kod tabanı indeksi, sembol tablosu, bağımlılık grafiği, proje özeti |
+| `audit/audit-trail.jsonl` | Ajanın yaptığı her işlemin denetim kaydı |
+| `checkpoints/stack.json`, `checkpoints/redo.json` | Geri al / yinele noktaları |
+| `mission-state.json`, `async-tasks.json` | Süren otonom misyonlar ve arka plan görevleri |
+| `agent-registry.json`, `services.json` | Kayıtlı ajanlar ve çalışan servisler |
+| `learned-errors.json`, `error-kb-local.json` | Projede öğrenilen hatalar ve çözümleri |
+| `chronicle.jsonl`, `digest.md` | Oturum günlüğü ve özet |
+| `project-map-cache.json` | Proje haritası önbelleği |
+| `telemetry/token-usage.jsonl`, `sessions/*-usage.json` | Token kullanımı |
+| `economy-state.json` | Bütçe / maliyet durumu |
+| `logs/` | Ajan logları |
+
+Proje klasörüne geri döndüğünüzde bu hafıza yüklenir; ajan kaldığı yerden devam eder.
+
+## 🔀 Git ve kaynak denetimi
+
+- **Commit mesajı üret** — değişikliklere bakıp anlamlı Türkçe mesaj yazar.
+- **Değişiklikleri incele (AI)** — commit öncesi kod incelemesi.
+- **Pull Request aç** — başlık ve açıklamayla.
+- Kaynak Denetimi panelinde tüm değişen dosyalar, grafik görünümü.
+
+## 🖥️ Terminal
+
+- **Doğal dilden terminal komutu üret:** *"3000 portunu kullanan süreci bul"*
+- **Terminal çıktısını sohbete gönder:** Hata çıktısını açıklat / düzelttir.
+- Ajan komutları entegre terminalde çalıştırır; çıkış kodlarını raporlar.
+
+## 🤖 Ajanlar
+
+| Ajan | Açıklama |
+|---|---|
+| **Arka plan ajanı** | Siz başka dosyada çalışırken görevi yürütür. |
+| **Bulut ajanı** | Görevi buluta devreder, bilgisayarınız serbest kalır. |
+| **Tarayıcı** | Uygulamayı gömülü tarayıcıda açar; ajan arayüzü görerek doğrular. |
+| **Design Mode** | Arayüz üzerinde görsel düzenleme. |
+| **AJANLAR sekmesi** | Sağ panelde çalışan ajanları izleme. |
+
+Ajanlar [Numex Core](04-numex-core.md) üzerinde çalışır: **Swarm Council** (Mimar · Kodlayıcı · Denetçi ·
+Tasarımcı), **Self-Healing** döngüsü ve **FinishGate** (kanıtsız "bitti" yok).
+
+## 🌍 Uzak geliştirme
+
+**SSH** veya **WSL** ile uzak sunucuya bağlanın; başlık çubuğunda *[Uzantı Geliştirme Konağı]* gibi
+bağlam gösterilir. Numex Çözüm uzak dosyalarla da aynı şekilde çalışır.
+
+## ⚙️ Ayarlar paneli
+
+**Numex Ayarları** menüleri: Hesap · **Token Kullanımı** (kalan bakiye, toplam satın alınan, toplam
+tüketilen, toplam istek; *Token Satın Al*) · Model & Sağlayıcı · Sohbet & Onay · **Mizah Modu** ·
+Editör & Tab · Kod Tabanı (RAG) · Görünüm & Tema · Başlangıç · Gelişmiş / CLI · API & Entegrasyon ·
+Kullanım Kılavuzu · Yardım · Hakkında. Ayrıca **ekran dili seçimi**.
+
+> Token Kullanımı ekranı yalnızca gerçek verileri gösterir; henüz sunucuda kaydı olmayan grafikler
+> "uydurma sayı göstermek yerine" gizlenir.
+
+## 📋 Tüm komutlar
+
+<details>
+<summary>Komut paletindeki Numex komutlarını göster</summary>
+
+| Komut |
+|---|
+| Hoş Geldiniz Sayfası |
+| Bu klasörde çalış · Çalışma klasörü seç · Çalışma klasörünü sıfırla |
+| Sohbeti Aç/Kapat · Sohbet Paneli · Yeni Sohbet · Sohbet Geçmişi · Transkripti Dışa Aktar |
+| Seçimi Sor · Bu Dosya Hakkında Sor · Seçimi Açıkla · Kod Lens Sorgusu |
+| Satır-içi Düzenle (Ctrl+K) · Sonraki Düzenlemeyi Uygula (Tab) · Sonraki Düzenleme Önerisini Kapat |
+| Projeyi İndeksle · Yeniden İndeksle (leksikal) · Anlamsal Aramayı Aç · Kod Tabanında Ara |
+| Ekran Görüntüsü Al ve Sohbete Ekle |
+| Terminal Komutu Üret · Terminal Çıktısını Sohbete Gönder |
+| Commit Mesajı Üret · Değişiklikleri İncele (AI) · Pull Request Aç |
+| Dosyadaki Hataları AI ile Düzelt |
+| Otonom Modu Aç/Kapat · Son Yanıtı Tekrar Üret |
+| Arka Plan Ajanı Başlat · Bulut Ajanı Başlat · Composer Aç |
+| Tarayıcıyı Aç · Design Mode Aç |
+| Uzak Sunucuya Bağlan (SSH/WSL) · SSH ile Bağlan · WSL ile Bağlan |
+| Ayarlar · Ekran Dilini Seç · Güncellemeleri Denetle · Destek / Hata Bildir |
+| Giriş Yap · Çıkış Yap |
+
+</details>
+
+## 📦 Kurulum
+
+**Masaüstü IDE:** [numexai.com.tr](https://numexai.com.tr) → *Numex Ailesi* → **Numex Codex IDE —
+Masaüstüne İndir**.
+
+**VS Code eklentisi:**
+```bash
+npm install -g @numexai/cli
+numex login
+# ardından VS Code'da Numex Codex eklentisini kurun
+```
+
+| Ayar | Varsayılan | Açıklama |
+|---|---|---|
+| `numex.command` | `numex` | CLI komutu / tam yol |
+| `numex.extraArgs` | — | REPL argümanları (ör. `--yolo --lint`) |
+
+## 🗓️ Bir günlük örnek akış
+
+1. Sabah projeyi açarsınız → `.numex/` hafızası yüklenir, durum çubuğu *"18 dosya indeksli"*.
+2. **Sohbet:** *"proje hakkında bilgi ver"* → ajan dosya ağacını tarar, Türkçe proje tanıtımı çıkarır.
+3. **Plan:** *"abonelik iptal hatırlatıcısı ekle"* → dosya dosya plan.
+4. **Otonom:** Planı onaylarsınız → ajan kodu yazar, testleri çalıştırır, FinishGate kanıt ister.
+5. **Hata Avcısı:** Konsolda hata → *"Terminal çıktısını sohbete gönder"* → kök neden + düzeltme.
+6. **Git:** *Commit mesajı üret* → *Pull Request aç*.
+7. Bir şey ters giderse: `numex undo` / checkpoint'ten geri dönüş.
+
+---
+← [Ürünler](README.md) · İlgili: [Numex CLI](02-numex-cli.md) · [Numex Core](04-numex-core.md)

urunler/04-numex-core.md

@@ -0,0 +1,78 @@
+# 🏛️ Numex Core (Corey) — Otonom Ajan Motoru
+
+**`@numex-ai/core`** · Numex ekosisteminin beyni ve motoru. Lisans: MIT
+
+> *"Çekirdek, ekosistemin beyni ve motorudur: bir isteği alıp kodu yazan, sonra durmayıp çalıştıran,
+> test eden ve dürüstçe denetleyen otonom ajan."* — Numexpedia
+
+CLI, Codex IDE, VS Code eklentisi, Codex Web ve SDK aynı çekirdeği kullanır. Bu yüzden terminaldeki
+komut ile editördeki buton **birebir aynı** davranır.
+
+## Mimari
+
+```mermaid
+flowchart LR
+    REQ[İstek] --> EMP[EmpathyEngine<br/>aciliyet · kalite modu]
+    EMP --> DOM[Alan tespiti<br/>LoRA → registry → SkillMemory → dinamik sentez]
+    DOM --> PLAN[PlanGate + Mimar planı]
+    PLAN --> SWARM{{Swarm Council}}
+    SWARM --> A[🏛️ Mimar]
+    SWARM --> C[💻 Kodlayıcı]
+    SWARM --> D[🔍 Denetçi]
+    SWARM --> T[🎨 Tasarımcı]
+    A & C & D & T --> HEAL[Self-Healing Loop<br/>PredictiveHealing · StuckDetector]
+    HEAL --> VIS[Omni-Vision<br/>Headless Chrome · DOM · 3D Canvas]
+    VIS --> GATE[FinishGate<br/>kanıt: HTTP 200 · test · DOM]
+    GATE -->|kanıt yok| HEAL
+    GATE -->|kanıt var| MEM[Self-Evolving Memory<br/>.agents/skills/SKILL.md]
+    MEM --> OUT[Teslim]
+```
+
+## Temel yetenekler
+
+| Yetenek | Açıklama |
+|---|---|
+| 🏛️ **Swarm Council** | Bütçe kontrollü 4 uzman ajan: **Mimar**, **Kodlayıcı**, **Denetçi**, **Tasarımcı**. Dinamik sentez sonrası mimari inceleme. |
+| 🧠 **3 katmanlı çıkarım** | **ONNX WASM** (≈25 MB, tamamen yerel) → **Ollama** (yerel LLM) → **Bulut API**. İnternet yokken de çalışabilir. |
+| 🔁 **Self-Healing Loop** | 3 turluk otonom hata tespit ve düzeltme döngüsü. |
+| 🚦 **FinishGate** | "Tamam/bitti" iddiası **kanıtsız geçemez** — canlı HTTP 200, birim testi veya DOM kontrolü ister. |
+| 👁️ **Omni-Vision** | Headless Chrome ile DOM ve 3D Canvas'ı görsel olarak denetler: kod gerçekten çalışıyor mu? |
+| 🧩 **NCP Protocol** | Blender 3D, Unity ve Figma için tak-çalıştır eklenti sistemi ([Eklenti mağazası](#-ncp-eklenti-mağazası)). |
+| 📚 **Self-Evolving Memory** | Oturumlarda bulunan çözümleri `.agents/skills/SKILL.md` altında saklar; bir dahakine hatırlar. |
+| 🗃️ **SQLite Cache** | Node 22+ `node:sqlite`, JSON dosya yedeğiyle önbellek motoru. |
+| 🧭 **StuckDetector** | Ajan döngüye girerse devreye girer; kullanıcıya veya web aramasına döner (autoPilot'ta bile). |
+| 🩺 **PredictiveHealing** | Sözdizimi, yapı, veri bütünlüğü, JSX parantez dengesi kontrolleri. |
+| 🎯 **Zero-Noise Pruning** | Büyük dosyada yalnızca ilgili satırları seçer (örnek: 537 satırda 41 ilgili satır, %92 gürültü filtrelendi). |
+| ⚡ **LRU File Cache** | 500 dosya limiti, mtime tabanlı, ~3× hız. |
+| 💞 **EmpathyEngine** | Kullanıcının acelesini / kalite beklentisini algılar, önceliklendirir. |
+| 🏗️ **E2E Deploy** | Scaffold → `npm install` → sunucu → health check → Playwright tarayıcı doğrulaması. |
+| 🎛️ **PlanGate** | API anahtarı + Free/Pro/Enterprise plan limitleri. |
+| 🎓 **LoRA Accumulator** | Doğrulanmış çözümlerden JSONL veri seti biriktirir (öz-eğitim döngüsü). |
+
+## Yol haritası seviyeleri
+
+| Seviye | Durum |
+|---|---|
+| 1 — CLI (terminal, komutlar, REPL) | ✅ |
+| 2 — Chat + Tools | ✅ |
+| 3 — RAG + Context (kod indeksleme) | ✅ |
+| 4 — Otonom kodlama (scaffold, E2E deploy) | ✅ |
+| 5 — Swarm Council (4 ajan konseyi, SkillMemory) | ✅ |
+| 6 — Sentetik Mimar (meta-reasoning, 12 sektör, öz-eğitim) | ✅ (geliştirme ortamında doğrulandı) |
+
+## Yapılandırma
+
+```js
+const core = require('@numex-ai/core');
+// autoPilot: true → plan/kod aşamalarında onay beklemeden ilerler.
+// StuckDetector her durumda aktif kalır.
+```
+
+## 🧩 NCP eklenti mağazası
+
+Çekirdek, NCP eklentilerini keşfetme, arama, `.numex/plugins/` altına indirme, kurma ve kaldırma
+desteği içerir. Örnek eklenti türleri: Blender sahne oluşturma/render, Figma tasarımını HTML/CSS'e
+dönüştürme. *(Eklenti kataloğu geliştirme aşamasındadır.)*
+
+---
+← [Ürünler](README.md) · İlgili: [Codex](03-numex-codex-ide.md) · [CLI](02-numex-cli.md) · [SDK](05-api-ve-sdk.md)

urunler/05-api-ve-sdk.md

@@ -0,0 +1,138 @@
+# 🔌 Numex Developer API & Codex SDK
+
+**Uygulamalarınıza Türkçe AI gücü katın.** Tek API ile sohbet, kod, görsel analiz, görsel üretimi,
+embedding ve arama.
+
+![Numex API](../gorseller/api.png)
+
+| | |
+|---|---|
+| **Sürüm** | API v1.0 |
+| **Base URL** | `https://www.numexai.com.tr/api/v1` |
+| **Kimlik doğrulama** | `Authorization: Bearer nx_live_…` |
+| **Bağlam** | 128K token |
+| **Hediye** | İlk kayıtta **100.000 token** — kartsız deneyin |
+| **Modeller** | `numex-pro` · `numex-fast` · `numex-think` · `numex-vision` · `numex-code` |
+| **Hedefler** | < 200 ms ortalama TTFB · %99,9 uptime hedefi (kurumsal SLA) |
+
+## 🧠 Modeller — "Her görev için doğru model"
+
+| Model | Etiket | Ne için? | Bağlam | Maks. çıktı | Yetenekler |
+|---|---|---|---|---|---|
+| ⚡ `numex-pro` | **En popüler** | En gelişmiş model: akıl yürütme, yaratıcılık, Türkçe'de en yüksek başarım; karmaşık görevler | 128K | 4K | Vision ✓ · Function calling ✓ |
+| 🚀 `numex-fast` | **Hızlı** | Hız ve maliyet odaklı: günlük görevler, sınıflandırma, basit sorgular | 32K | 4K | Vision ✓ · ~3× hızlı |
+| 🧠 `numex-think` | **Düşünce** | Derin akıl yürütme: matematik, mantık, strateji, çok adımlı problem çözümü | 128K | 8K | Chain-of-thought |
+| 🖼️ `numex-vision` | **Görsel** | Görsel anlama ve analiz: resim açıklama, OCR, görüntü tabanlı görevler | — | — | Image → Text · OCR · Türkçe |
+| 💻 `numex-code` | **Kod** | Kod üretimi: otomatik tamamlama, bug fix, code review, refactoring | 64K | 8K | 25+ programlama dili |
+
+> Modeller planınıza göre değişir; yetenekler API referansında ve `GET /api/v1/features` ile doğrulanır.
+
+## 🚀 Hızlı başlangıç
+
+**cURL**
+```bash
+curl -X POST https://www.numexai.com.tr/api/v1/chat \
+  -H "Authorization: Bearer nx_live_ANAHTARINIZ" \
+  -H "Content-Type: application/json" \
+  -d '{"message":"Merhaba","history":[]}'
+```
+
+**Python**
+```python
+import requests
+r = requests.post(
+    "https://www.numexai.com.tr/api/v1/chat",
+    headers={"Authorization": "Bearer nx_live_ANAHTARINIZ", "Content-Type": "application/json"},
+    json={"message": "Merhaba", "history": []},
+)
+print(r.json().get("answer", ""))
+```
+
+**Node.js (Codex SDK)**
+```javascript
+const { Numex } = require('numexcodex-sdk');
+const numex = new Numex({ apiKey: process.env.NUMEX_API_KEY });
+
+const res = await numex.chat.completions.create({
+  messages: [{ role: 'user', content: 'Merhaba' }],
+});
+```
+
+## 📚 Uç noktalar
+
+### Yapay zeka
+| Yöntem | Yol | Açıklama |
+|---|---|---|
+| `POST` | `/chat` | Sohbet yanıtı |
+| `POST` | `/chat/stream` | Akışlı (streaming) sohbet |
+| `POST` | `/chat/agent` | Ajan modunda çok adımlı görev |
+| `POST` | `/vision` | Görsel analiz |
+| `POST` | `/images/generations` | Görsel üretimi |
+| `POST` | `/embeddings` | Vektör gömme (RAG, anlamsal arama) |
+| `POST` | `/search` | Web araması + özet |
+| `GET` | `/models` | Kullanılabilir modeller |
+| `GET` | `/features` | Hesabınızda açık yetenekler |
+
+### Hesap, anahtar ve kullanım
+| Yöntem | Yol | Açıklama |
+|---|---|---|
+| `GET` | `/me` · `/account` | Hesap bilgisi |
+| `GET` / `POST` | `/me/keys` | Anahtarları listele / oluştur |
+| `POST` | `/keys/:id/rotate` | Anahtarı döndür (rotate) |
+| `POST` | `/keys/:id/activate` | Anahtarı etkinleştir |
+| `DELETE` | `/keys/:id` | Anahtarı sil |
+| `GET` | `/usage` · `/usage/history` | Token kullanımı ve geçmiş |
+| `GET` | `/me/models` · `POST /me/preferred-model` | Model tercihleri |
+| `POST` | `/me/test-key` | Anahtar testi |
+| `GET` | `/plans` · `POST /subscribe` · `POST /tokens/purchase` · `GET /payments` | Plan, abonelik, token satın alma |
+
+### CLI cihaz girişi
+| Yöntem | Yol | Açıklama |
+|---|---|---|
+| `POST` | `/cli/device` | Cihaz kodu al (`numex login`) |
+| `GET` | `/cli/device/:deviceCode` | Onay durumunu sorgula |
+| `POST` | `/cli/device/authorize` | Tarayıcıdan onayla |
+
+> Yetenekler plana göre değişir; güncel liste `GET /api/v1/features` ile doğrulanır.
+
+## 🧰 Codex SDK (`numexcodex-sdk`)
+
+```bash
+npm install numexcodex-sdk
+```
+
+| Kaynak | Metot |
+|---|---|
+| `numex.chat.completions` | `create({ messages, stream })` |
+| `numex.embeddings` | `create({ input })` |
+| `numex.images` | `generate({ prompt })` |
+| `numex.models` | `list()` |
+| `numex.search` | `query({ q })` |
+
+**CLI Bridge — programatik komut çalıştırma**
+```javascript
+const { Numex, NumexBridge } = require('numexcodex-sdk');
+
+const numex = new Numex({ command: 'numex' });           // PATH'teki CLI
+const r = await numex.run(['--help'], { timeout: 60000 });
+console.log(r.success ? r.stdout : r.error);
+
+const bridge = new NumexBridge({ command: process.execPath }); // PATH bağımsız
+```
+
+Böylece CI hatlarınıza, iç araçlarınıza veya kendi ajanlarınıza Numex CLI'nin tüm otonom gücünü tek
+satırla gömebilirsiniz. TypeScript tanımları (`index.d.ts`), CommonJS ve ESM desteği vardır.
+
+## 🔐 Güvenlik notları
+
+- Anahtar yalnızca oluşturulduğunda bir kez gösterilir — güvenli saklayın.
+- Anahtarları döndürme (rotate) ve silme desteklenir.
+- Anahtarı istemci tarafı koda (tarayıcı JS) gömmeyin; sunucunuzdan çağırın.
+
+## 💳 API erişimi hangi planda?
+
+**Numex PRO** (₺399/ay) → CLI + API · **Advanced** (₺599/ay) → tam CLI + tam API.
+Kota biterse **Numex Kredisi** ile kullandıkça ödeyin.
+
+---
+← [Ürünler](README.md)

urunler/06-hub-ve-forge.md

@@ -0,0 +1,102 @@
+# 📦 Numex Hub & Numex Forge
+
+**Depo yönetimi ve AI destekli geliştirme — tek Numex hesabıyla.**
+
+🔗 **Hub:** [hub.numexai.com.tr](https://hub.numexai.com.tr) · **Forge:** [forge.numexai.com.tr](https://forge.numexai.com.tr)
+
+![Numex Hub](../gorseller/hub.png)
+
+> Git depolarını oluştur, yönet, AI ile düzenle. Numex'e giriş yap, Hub'ı ve Forge'u otomatik kullan.
+> **Ayrı kayıt yok, ayrı şifre yok — tek Numex hesabı, tüm ekosistem.**
+
+## Hub ve Forge'un farkı
+
+| | 🏗️ **Forge** | 📦 **Hub** |
+|---|---|---|
+| **Ne?** | **Gitea tabanlı Git sunucusu** | Forge'un üzerinde çalışan **AI destekli depo yönetim arayüzü** |
+| **Rolü** | Depolar gerçek Git: gerçek commit, gerçek tarih | Depo oluştur, dosya düzenle, AI ile değiştir, commit'le |
+| **Benzetme** | "Numex'in GitHub'ı" | "Deposunu bilen yapay zeka editörü" |
+
+## Hub ne yapar?
+
+![Hub özellikleri](../gorseller/hub-ozellikler.png)
+
+| Özellik | Açıklama | Durum |
+|---|---|---|
+| 📦 **Git depo yönetimi** | Depo oluştur, dosyaları düzenle, commit geçmişini gör. Tüm depolar Forge üzerinde. | |
+| 🤖 **AI destekli düzenleme** | Sohbetten *"README'yi güncelle"* yaz, AI kod bloğu önersin; onayla, Forge'a commit'lensin. | Beta |
+| 🔐 **Tek hesap, tüm ekosistem** | Google veya GitHub ile giriş; Hub ve Forge otomatik açık. | |
+| 🏗️ **Forge entegrasyonu** | Gitea tabanlı gerçek Git sunucusu. | Beta |
+| 💬 **Depo bağlamlı sohbet** | AI deponun dosyalarını bilir: *"index.js'ye fonksiyon ekle"* → dosyayı okur, değişikliği önerir. | Beta |
+| ⚡ **Anlık uygulama** | Öneriyi gör, **Uygula** de → anında commit. Commit SHA'sını gör, geri al. | Beta |
+
+## 🌍 Topluluk Vitrini — `hub.numexai.com.tr/topluluk` *(YENİ)*
+
+> *"Binlerce geliştiricinin inşa ettiği otonom projeleri keşfedin. Kendi vizyonunuzla birleştirin ve
+> sınırları kaldırın."*
+
+Hub'ın üst menüsü: **Uygulama Marketi · Topluluk · Dokümantasyon · Panoya Dön**.
+
+| Bölüm | Ne var? |
+|---|---|
+| ⭐ **Trend Depolar** | Topluluğun öne çıkan depoları: kullanıcı adı, dil etiketi (TypeScript, Python, Rust, CSS…), açıklama, ⭐ yıldız ve 🍴 çatal sayıları |
+| 🍴 **Çatalla** | Beğendiğin depoyu tek tıkla kendi hesabına çatalla (fork), üzerine geliştir |
+| 🔍 **Depolarda ara** | Topluluk depolarında arama |
+| 📡 **Canlı Akış — Canlı Numex Ağı** | Anlık etkinlik: *push*, *fork*, *star*, *PR açtı* — "5 dk önce", "1 saat önce" |
+
+Örnek depo türleri: otonom e-ticaret asistanı, Türkçe NLP/RAG çekirdeği, Windows paketleme CLI'ı,
+erişilebilir UI kit.
+
+## Nasıl çalışır? — 4 adım, kurulum yok
+
+![Hub nasıl çalışır](../gorseller/hub-nasil-calisir.png)
+
+1. **Numex'e giriş yap** — numexai.com.tr'de Google veya GitHub ile.
+2. **Hub'ı aç** — hub.numexai.com.tr'ye git; giriş yapmış halde gelirsin. Depolarını gör, yeni depo oluştur.
+3. **AI'a değişikliği söyle** — depoyu aç, sohbete yaz: *"README'yi güncelle"*, *"yeni fonksiyon ekle"*.
+4. **Uygula → Forge'a commit** — değişiklik commit'lenir; geçmişte görünür, istediğinde geri alınır.
+
+## 🏗️ Numex Forge — ayrıntılı
+
+🔗 [forge.numexai.com.tr](https://forge.numexai.com.tr) · **Gitea** tabanlı, **tamamen Türkçe** arayüz.
+
+| Menü | Ne yapar? |
+|---|---|
+| **Konular** | Issue takibi — hata ve istekler |
+| **Değişiklik İstekleri** | Pull request — kod incelemesi ve birleştirme |
+| **Kilometre Taşları** | Sürüm / hedef planlama |
+| **Keşfet** | Herkese açık **Depolar**, **Kullanıcılar**, **Organizasyonlar** — arama, filtre, sıralama |
+| **Pano** | Katkı ısı haritası (son 12 ay), etkinlik akışı, depolarım |
+| **Depo / Organizasyon** | Depo oluşturma; Kaynaklar · **Çatallar** · **Yansılar** (mirror) filtreleri; özel/açık depo |
+
+### `numexai` organizasyonundan örnek açık depolar
+
+Numex'in otonom ürettiği uygulamaların kaynak kodu Forge'da herkese açık durur:
+
+| Depo | Açıklama | Dil |
+|---|---|---|
+| `numex-ilan` | İlan verme, arama ve listeleme özellikli örnek ilan/pazar platformu arayüzü | JavaScript |
+| `novax-saat` | Akıllı saat konseptini tanıtan etkileşimli, animasyonlu ürün deneyimi sayfası | HTML |
+| `nn-core` | Yapay sinir ağının çekirdeğini görselleştiren etkileşimli demo | JavaScript |
+| `depo-yonetim` | Ürün, stok ve depo hareketlerini tek panelden yöneten arayüz | JavaScript |
+| `envanter-dokuman` | Bir envanter API'sinin uç noktalarını anlatan interaktif belge sayfası | JavaScript |
+| `randevu-sistemi` | Randevu oluşturma, listeleme ve takip arayüzü | JavaScript |
+| `resim-duzenleyici` | Tarayıcıda kırpma, filtre ve ayarlarla fotoğraf düzenleme | HTML |
+| `kelime-sayaci` | Metindeki kelime, karakter ve cümle sayısını anlık gösteren araç | HTML |
+| `markdown-defter` | Markdown not defteri | HTML |
+
+## Ekosistemdeki yeri
+
+```mermaid
+flowchart LR
+    CODEX[Codex Web / IDE / CLI] -->|proje| FORGE[(🏗️ Forge<br/>Gitea · gerçek Git)]
+    HUB[📦 Hub<br/>AI depo arayüzü] <--> FORGE
+    MARKET[🛍️ Numex Market<br/>44 açık kaynak uygulama] -->|kaynak kodu| FORGE
+    PEDIA[📖 Numexpedia] -.bağlantı.-> FORGE
+```
+
+**Numex Market**'teki açık kaynak uygulamaların kaynak kodu Forge'da durur; Market, Pedia ve Hub
+menülerinde **"Forge'a Git"** bağlantısı bulunur.
+
+---
+← [Ürünler](README.md) · İlgili: [Numex Market](13-numex-market.md) · [Codex](03-numex-codex-ide.md)

urunler/07-deepview.md

@@ -0,0 +1,49 @@
+# 🔬 Numex DeepView™
+
+**"AI'ın sadece ne söylediğini değil, nasıl düşündüğünü görün."** · v1.0 · Mart 2025
+
+![DeepView](../gorseller/deepview.png)
+
+DeepView, Numex AI'ın **entegre çoklu uzman orkestratörüdür**. Tek soruyu alır, ilgili uzmanlara
+paralel dağıtır, hakem sistemiyle tek tutarlı belgede toplar ve akıl yürütme sürecini **6 katmanda**
+görselleştirir.
+
+## Mimari
+
+![DeepView orkestratör](../gorseller/deepview-orkestrator.png)
+
+```
+👤 Kullanıcı ──▶ 🧠 Beyin (Router) ──▶  Paralel uzmanlar  ──▶ ⚖️ Hakem ──▶ 📋 Master Plan
+ karmaşık soru     analiz & dağıtım     @Backend  — mimari        çelişki çözme   tek entegre belge
+ + @uzman          Boru 1 + mod tespiti @DevOps   — altyapı       birleştirme     roadmap + matris
+                                        @Security — güvenlik
+                                        @Muhasebeci — maliyet
+```
+
+| Kural | Açıklama |
+|---|---|
+| **Tetikleyici** | 2+ `@uzman` etiketi veya *"Master Plan"* / *"entegre taslak"* ifadesi |
+| **Yedek kural** | 300+ karakter ve birden fazla konu alanı |
+| **Garanti** | Tek tek karakter girişleri yok — **tek entegre Master Plan** |
+
+## 6 katman
+
+| # | Katman | Ne gösterir? |
+|---|---|---|
+| 01 | 💭 **Thought Stream** | Düşünce adımlarını sırayla ve süreleriyle (tüm modlarda aktif) |
+| 02 | 🧠 **Reasoning Panel** | Problem → Kök neden → Çözüm → Fayda zinciri |
+| 03–06 | 📊 Ara sonuçlar, uzman katkıları, hakem kararları ve nihai plan | Karar sürecinin izlenebilir kaydı |
+
+**Örnek:** *"@Backend @DevOps @Security @Muhasebeci aidat takip SaaS'ı için entegre taslak"* →
+mimari, altyapı, güvenlik ve maliyet tek belgede; yol haritası ve karar matrisiyle.
+
+## Detective Mode™ ve Multi-Agent ile ilişkisi
+
+![Multi-Agent](../gorseller/multi-agent.png)
+
+- **Detective Mode™:** Aynı soruyu birden çok model çözer, hakem en doğrusunu seçer.
+- **Multi-Agent:** Görevi alt görevlere böler, uzman ajanlara dağıtır, birleştirir.
+- **DeepView:** Bu sürecin **görünür** hali — kullanıcı her katmanı izler.
+
+---
+← [Ürünler](README.md) · [Mimari](../docs/mimari.md)

urunler/08-karakterler.md

@@ -0,0 +1,39 @@
+# 🇹🇷 Numex Türkçe Karakter Sistemi
+
+Türk kültürüne ve günlük Türkçe'ye göre ayarlanmış **uzman karakterler**. Sohbet kutusunda `@`
+yazarak çağrılır. Her karakterin kendi alanı, konuşma tonu ve alan anahtar kelimeleri vardır; sorunuz
+bir karakterin alanına girdiğinde uygun karakter öne çıkar.
+
+| Karakter | Alan | Örnek soru |
+|---|---|---|
+| 👵 **@FatmaAna** | Yemek tarifleri, mutfak, leke/temizlik, saklama, ev ekonomisi, bayram & ramazan sofraları | *"4 kişilik bütçe dostu iftar menüsü"* |
+| 🌿 **@LokmanHekim** | Sağlıklı yaşam sohbetleri (tıbbi teşhis yerine geçmez) | *"Kış aylarında bağışıklık için neler yapılır?"* |
+| 🎓 **@Üstat** | Bilgelik, öğretmenlik, kavram anlatımı | *"Stoacılığı sade bir dille anlat"* |
+| 🕌 **@HaciBayramHoca** | Dua, ayet, hadis, tefsir, helal-haram, maneviyat | *"Felak suresinin anlamı nedir?"* |
+| 🧾 **@MuhasebeciYunus** | Vergi, muhasebe, KDV, stopaj, beyanname, SGK, GİB, e-fatura, amortisman | *"Şahıs şirketinde KDV beyannamesi ne zaman verilir?"* |
+| ⚖️ **@Avukat** | Hukuki konularda genel bilgilendirme | *"Kira artışında yasal sınır nedir?"* |
+| 💻 **@Kod** (Kod Ustası) | Yazılım, debug, kod açıklama | *"@Kod bu fonksiyondaki hatayı çöz"* |
+
+> Numex, "9 Türkçe karakter"den söz eder; yukarıdakiler kodda tanımlı olan karakterlerdir.
+> Advanced planında **özel karakter oluşturma** da vardır.
+
+## Neden karakter?
+
+- **Doğru ton:** FatmaAna'nın sıcaklığı ile MuhasebeciYunus'un titizliği aynı değildir.
+- **Doğru bağlam:** Alan anahtar kelimeleri sayesinde karakter, konuyu doğru çerçeveler.
+- **Güvenli sınırlar:** Sağlık, hukuk, din gibi hassas alanlarda karakterler genel bilgi verir,
+  uzmana yönlendirir.
+
+## DeepView ile birlikte
+
+Birden fazla uzman etiketi (`@Backend @Security @Muhasebeci …`) kullanıldığında
+[DeepView™](07-deepview.md) devreye girer ve tek bir **Master Plan** üretir.
+
+## Planlara göre
+
+Ücretsiz: — · Başlangıç PRO: 3 karakter · Numex PRO: tüm karakterler · Advanced: tümü + özel karakter.
+
+> *"FatmaAna karakteri müthiş! Annem bile kullanıyor artık."* — Bireysel kullanıcı
+
+---
+← [Ürünler](README.md)

urunler/09-pc-doktoru.md

@@ -0,0 +1,38 @@
+# 🩺 PC Doktoru Süper Ajan
+
+**Windows için yapay zeka destekli, portable bakım, teşhis ve tamir asistanı.** · v3.1
+🔗 [pcdoktoru.com.tr](https://pcdoktoru.com.tr) · 💻 [GitHub](https://github.com/mobilcep/pcdoktoru)
+
+Numex Ailesi'nde **"aynı ekipten"** ürün. Numex Agent'ın *tespit → plan → onay → uygula*
+yaklaşımının Windows masaüstündeki hali.
+
+| | |
+|---|---|
+| **94/100** | Süper Ajan kalite puanı |
+| **18+** | Bakım & tamir aracı |
+| **%100** | Offline çalışabilir |
+| **₺0** | Kurulum yok, reklam yok |
+
+## Özellikler
+
+| | Özellik | Açıklama |
+|---|---|---|
+| 🛡️ | **Süper Ajan puanlama** | 6 direkli sistem kalitesi skoru ve proaktif öneriler |
+| 🤖 | **Yapay zeka asistanı** | Doğal dille teşhis, tamir, dosya arama — yerel **Ollama** veya offline kural tabanlı mod |
+| ⚙️ | **Otonom mod** | Tespit → eylem planı → **onay** → uygula |
+| ↩️ | **Rollback & güvenli tamir** | Riskli işlemden önce geri yükleme noktası; her adım kayıtlı |
+| 🔐 | **Güvenlik & denetim** | Komut beyaz listesi, audit log, Windows olay günlükleri, VPN yardımcısı |
+| 📦 | **Yazılım Merkezi** | **winget** ile program ara/kur, eksik bileşenleri tamamla |
+| 🗂️ | **Dosya zekası** | Dosyaları doğal dille bul |
+
+## Başlangıç
+1. Portable ZIP'i indir, çıkar · 2. `PC Doktoru.exe` → **Yönetici olarak çalıştır** ·
+3. Lisans anahtarı (`PCD-XXXX-XXXX-XXXX-XXXX`) veya **14 gün ücretsiz deneme** · 4. Tek tıkla tam bakım.
+
+Windows 10/11 64-bit · ~400 MB.
+
+## Fiyat
+Deneme ₺0 (14 gün) · **Bireysel ₺349/yıl** (2 cihaz) · **Aile ₺549/yıl** (5 cihaz) · İşletme: teklif.
+
+---
+← [Ürünler](README.md)

urunler/10-pusulamx.md

@@ -0,0 +1,19 @@
+# 🧭 PusulamX (Pusulam) — İşletmeler İçin Numex Gücü
+
+**Ön muhasebe & POS** · 🔗 [pusulamx.com.tr](https://pusulamx.com.tr) · 2026
+
+Numex Ailesi'nde **"aynı ekipten"** ürün.
+
+> **"Pusulam"**, işletmenizin rotasını güvenle bulmanızı sağlayan analitik rehberliği temsil eder.
+> İsimdeki **"X"** ise **eXponential** (katlanarak artan) büyümeyi, sınırsız potansiyeli ve insan ile
+> yapay zekanın birleşimindeki **çarpan etkisini** ifade eder.
+
+**Amaç:** KOBİ'lerin **ön muhasebe** ve **POS** süreçlerinde "X" çarpanıyla büyümesini sağlamak.
+
+## Numex ile bağlantısı
+- Muhasebe sorularında **@MuhasebeciYunus** karakteri (KDV, stopaj, beyanname, SGK, e-fatura).
+- Codex'te **Muhasebe** ve **Satış / POS** proje türleri — ajan bu sektörlere göre mimari kurar.
+- Veriler Türkiye'de, KVKK uyumlu altyapı.
+
+---
+← [Ürünler](README.md)

urunler/11-numex-okul.md

@@ -0,0 +1,50 @@
+# 🎓 Numex Okul — Yapay Zekâ Destekli Test Platformu
+
+🔗 **[okul.numexai.com.tr](https://okul.numexai.com.tr)** · *Doğrulanmış testler*
+
+> **Eğitimde AI Devrimi** — Öğrenciler, veliler ve öğretmenler için yapay zekâ destekli test
+> platformu. *Konunu seç, doğrulanmış testini al, eksiğini gör, geleceğini şekillendir.*
+
+## Nasıl çalışır?
+
+```
+① Seviye & konu seç  ──▶  ② AI üretir, ikinci AI doğrular  ──▶  ③ Ekranda çöz ya da PDF al
+```
+
+1. **Seviye** (ör. 8. Sınıf), **Ders** (ör. Matematik) ve **Konu** seçilir — konu yazılıp Enter'a
+   basılabilir ya da hazır konu çiplerinden seçilir (*Çarpanlar ve Katlar, Üslü İfadeler, Kareköklü
+   İfadeler, Cebirsel İfadeler, Doğrusal Denklemler, Eşitsizlikler, Olasılık, Üçgenler…*).
+2. **Soru sayısı**, **zorluk** (Kolay / Orta / Zor) ve **süre** (Süresiz ya da süreli) ayarlanır.
+3. İsteğe bağlı **"Önce Konu Anlatımı"** — testten önce konunun özeti.
+4. **Testi Oluştur.**
+
+## 🛡️ Çift yapay zeka doğrulaması
+
+Numex Okul'un farkı: her soruyu **bir AI hazırlar, ikinci bir AI bağımsız olarak çözer**.
+
+| Soru | Hazırlayan | Doğrulayan | Sonuç |
+|---|---|---|---|
+| 1 | B | B | ✅ **Onaylandı** |
+| 2 | C | A | ❌ **Elendi** — yerine yeni soru üretilip aynı kontrolden geçirilir |
+| 3 | D | D | ✅ **Onaylandı** |
+
+İki yapay zekanın cevabı uyuşmayan soru **teste girmez**. Böylece yanlış cevap anahtarlı soru riski
+en aza iner — [Detective Mode™](07-deepview.md) yaklaşımının eğitimdeki uygulaması.
+
+## ⚡ Hızlı başla — tek tıkla örnek test
+
+| | |
+|---|---|
+| 📘 **LGS Hazırlık** — 8. Sınıf · Matematik | Σ **TYT Matematik** — Temel Kavramlar |
+| ⚡ **AYT Fizik** — Kuvvet ve Hareket | 🌐 **Lise İngilizce** — Tenses |
+| 🚗 **Ehliyet Sınavı** — Trafik İşaretleri | 📗 **Ortaokul Türkçe** — Sözcükte Anlam |
+
+## Kimler için?
+- **Öğrenciler:** LGS, TYT, AYT hazırlığı; eksik konuyu görme.
+- **Veliler:** Çocuğun seviyesine uygun, doğrulanmış deneme.
+- **Öğretmenler:** Dakikalar içinde PDF test; sınıfa dağıtım.
+- **Kurumlar:** **Kurumsal** hesap desteği.
+- **Herkes:** Ehliyet sınavı gibi genel sınavlar.
+
+---
+← [Ürünler](README.md)

urunler/12-guvenlik-kvkk.md

@@ -0,0 +1,36 @@
+# 🔒 Güvenlik, Gizlilik ve KVKK
+
+## Veri nerede?
+- Veriler **Türkiye sınırları içinde** işlenir ve saklanır; **KVKK** standartlarına uyumlu.
+- **Çift sunucu mimarisi:** her biri 256 GB RAM; biri devre dışı kalırsa diğeri devralır. **SAS + NAS** depolama.
+- Global altyapı sağlayıcıları (Google Cloud, Microsoft Azure, Anthropic, Vercel, Meta, MongoDB,
+  DeepSeek) yalnızca altyapı sağlar; veri işleme ve saklama **Numex politikasına** tabidir.
+
+![Teknoloji ortakları](../gorseller/teknoloji-ortaklar.png)
+
+## Kimlik ve erişim
+- **Google** ve **GitHub** OAuth — tek hesap, tüm ekosistem (Web, CLI, Codex, Hub, Forge).
+- CLI için **cihaz kodu** ile tarayıcı onaylı giriş (`numex login`).
+- API anahtarları `nx_live_` önekli; bir kez gösterilir; **rotate** ve silme desteklenir.
+- Üretimde zayıf JWT anahtarları reddedilir.
+
+## Ajan güvenliği
+- **Onay kapısı:** Otonom/Agent modları plan sunar, onay olmadan başlamaz (*"anlaşalım, sonra yapalım"*).
+- **Diff önizleme:** Her dosya değişikliği kabul/ret için gösterilir.
+- **Geri alma:** `numex undo`, `.numex/checkpoints`, PC Doktoru'nda sistem geri yükleme noktası.
+- **Denetim izi:** `.numex/audit/audit-trail.jsonl` — ajanın yaptığı her işlem.
+- **FinishGate:** "Bitti" demek için kanıt şart.
+- **Komut beyaz listesi** (PC Doktoru).
+
+## Ödeme
+İyzico altyapısı · 256-bit SSL · kart bilgisi Numex sunucularında saklanmaz · kredi/banka kartı ve QR.
+
+## Şeffaflık
+Detective Mode™ gerekçeli karar · DeepView™ 6 katmanlı düşünce görünümü · gerçek veri yoksa
+"uydurma sayı göstermeyen" paneller.
+
+## Erişilebilirlik
+Yüksek kontrast, büyük yazı, ekran okuyucu desteği.
+
+---
+← [Ürünler](README.md)

urunler/13-numex-market.md

@@ -0,0 +1,76 @@
+# 🛍️ Numex Market
+
+🔗 **[market.numexai.com.tr](https://market.numexai.com.tr)** · *Açık Kaynak · Ücretsiz · Otonom Üretim*
+
+> **Numex AI'nın sıfırdan kodladığı uygulamalar — hepsi ücretsiz ve açık kaynak.**
+> İster çalışan halini indir, ister kodunu incele, ister kendine göre değiştir.
+
+| **44** | **7** | **₺0** |
+|:---:|:---:|:---:|
+| Uygulama | Kategori | Her zaman ücretsiz |
+
+## Market nedir?
+
+Numex Market, **Numex Çekirdeği'nin otonom olarak ürettiği** uygulamaların vitrinidir. Buradaki her
+uygulama bir insan tarafından tek tek kodlanmadı: Numex'e *"şunu yap"* denildi, ajan yazdı, çalıştırdı,
+test etti ve [FinishGate](04-numex-core.md) kanıtıyla teslim etti. Sonuç herkese açık:
+
+- ⬇️ **İndir** — çalışan halini hemen kullan
+- 👀 **İncele** — kaynak kodu [Numex Forge](06-hub-ve-forge.md)'da açık
+- 🍴 **Değiştir** — çatalla, kendine göre uyarla (Hub'da **Çatalla**)
+
+Bu yüzden Market aynı zamanda Numex'in ne üretebildiğinin **canlı kanıtıdır**.
+
+## Kategoriler
+
+| Kategori | Uygulama | Ne var? |
+|---|:---:|---|
+| 🎮 **Oyunlar** | 6 | Tarayıcıda ve masaüstünde çalışan otonom üretilmiş oyunlar |
+| 🧪 **Simülasyon** | 4 | Etkileşimli simülasyonlar ve görselleştirmeler |
+| 🤖 **Yapay Zeka** | 3 | AI demoları (ör. sinir ağı çekirdeği görselleştirmesi) |
+| 🛠️ **Araçlar / Yardımcı** | 12 | Kelime sayacı, resim düzenleyici, Markdown defter gibi günlük araçlar |
+| ⚡ **Üretkenlik** | 8 | Randevu sistemi, depo/stok yönetimi, envanter gibi iş araçları |
+| 🖥️ **Web / OS** | 3 | Web tabanlı masaüstü/işletim sistemi deneyimleri |
+| 📦 **Diğer** | 8 | Ürün tanıtım sayfaları, ilan platformu ve daha fazlası |
+
+## 🎧 Örnek: Cyber Beats
+
+🔗 **[dene.numexai.com.tr/cyberbeats](https://dene.numexai.com.tr/cyberbeats/)**
+
+Market uygulamaları **dene.numexai.com.tr** üzerinde kurulum gerektirmeden canlı denenebilir.
+**Cyber Beats**, Numex'in otonom ürettiği tarayıcı tabanlı bir **16 adımlı ritim makinesi**:
+
+| Özellik | Açıklama |
+|---|---|
+| 🥁 **4 kanal** | KICK · SNARE · HAT · SYNTH |
+| 🔢 **16 adım** | Hücreye tıkla → nota ekle/çıkar; çalan adım canlı vurgulanır |
+| 🎚️ **Tempo** | Kaydırıcıyla BPM ayarı (varsayılan 120) |
+| ⏯️ **Kontroller** | Oynat/Duraklat (`Space`), Durdur, CLEAR |
+| 🔊 **Ses motoru** | Tüm sesler **saf Web Audio API** ile sentezlenir — tek bir ses dosyası yok |
+| 🎨 **Tasarım** | Neon siberpunk arayüz, durum göstergesi (● ÇALIYOR) |
+
+Bir cümlelik istekten çalışan, test edilmiş ve yayınlanmış bir uygulamaya: Market'teki 44
+uygulamanın her biri bu hattan geçti.
+
+## Nasıl kullanılır?
+
+1. **Keşfet** — kategori çiplerinden seç ya da *"Uygulama ara… (isim veya açıklama)"* kutusunu kullan.
+2. **Kartı aç** — ekran görüntüsü, açıklama, kategori.
+3. **Dene** (dene.numexai.com.tr), **İndir** ya da **Forge'a Git** → kaynak kod.
+4. Beğendiysen **Hub**'da çatalla; **Codex**'te aç, *"bunu koyu temaya çevir"* de.
+
+## Market ↔ ekosistem
+
+```mermaid
+flowchart LR
+  CORE[🧠 Core — Beyin<br/>otonom üretim] --> FORGE[(🏗️ Forge<br/>kaynak kod)]
+  FORGE --> MARKET[🛍️ Market<br/>44 uygulama]
+  MARKET -->|indir| USER[👤 Kullanıcı]
+  MARKET -->|çatalla| HUB[📦 Hub]
+  HUB -->|düzenle| CODEX[🧩 Codex]
+```
+
+Hub'ın menüsündeki **Uygulama Marketi** bağlantısı da buraya çıkar.
+
+---
+← [Ürünler](README.md) · İlgili: [Hub & Forge](06-hub-ve-forge.md) · [Oyun Bahçesi](16-oyun-bahcesi.md)

urunler/14-numexpedia.md

@@ -0,0 +1,46 @@
+# 📖 Numexpedia — Özgür Türkçe Ansiklopedi
+
+🔗 **[pedia.numexai.com.tr](https://pedia.numexai.com.tr)** · *Özgür · Ücretsiz · Türkçe*
+
+> **Bilgisayar, yapay zeka ve yazılım dünyasını herkesin anlayacağı sade Türkçe ile anlatıyoruz.**
+> Öğrenmek isteyen herkes için — ücretsiz ve özgür.
+
+| **28** | **8** | **₺0** |
+|:---:|:---:|:---:|
+| Makale | Kategori | Her zaman ücretsiz |
+
+## Kategoriler
+
+| Kategori | Makale |
+|---|:---:|
+| 🧠 Yapay Zeka | 4 |
+| 🗂️ Yazılım | 3 |
+| `</>` Programlama | 3 |
+| 🖥️ Donanım | 2 |
+| 🌐 İnternet & Ağlar | 1 |
+| 🛡️ Güvenlik | 2 |
+| ◆ **Numex Ekosistemi** | **13** |
+
+Her makalede kategori etiketi ve **okuma süresi** (4–5 dk) bulunur; *"Ansiklopedide ara… (ör. yapay
+zeka, algoritma, internet)"* kutusuyla aranır.
+
+## Öne çıkan makaleler
+
+| Makale | Özet |
+|---|---|
+| **Dedektif Modu (Detective Mode) Nedir?** | Aynı soruyu birden çok yapay zeka modeline çözdürüp, bir hakem modelin en iyi cevabı gerekçesiyle seçtiği çok-modelli tartışma sistemi. |
+| **Numex Nedir?** | Numex, kod üreten bir araç değil; ürettiği yazılımı kendi kendine doğrulayan, kullanan ve gerektiğinde yeniden geliştiren, yazılımcının yanındaki yerli bir yoldaştır. |
+| **Numex Çekirdek (Core) Nedir?** | Ekosistemin beyni ve motoru: bir isteği alıp kodu yazan, sonra durmayıp çalıştıran, test eden ve dürüstçe denetleyen otonom ajan. |
+| **Numex Codex Nedir?** | Numex Çekirdeği'ne tarayıcıdan erişilen web istemcisi: kurulum gerektirmeden, sohbet eder gibi kod üretip çalıştırıp yayınlamayı sağlar. |
+| **Numex CLI Nedir?** | Numex ajanını doğrudan terminalden çalıştırmayı sağlayan komut satırı arayüzü — otomasyona ve uzak sunuculara en yakın yüz. |
+| **Numex SDK Nedir?** | Çekirdeğin yeteneklerini kendi uygulamana gömmek için geliştirici kütüphanesi — ekosistemi kapalı bir uygulama değil, bir platform yapar. |
+
+## Neden Numexpedia?
+
+- **Sade Türkçe:** Teknik kavramlar jargonsuz, herkesin anlayacağı dille.
+- **Özgür ve ücretsiz:** Üyelik, ödeme, reklam yok.
+- **Ekosistemin el kitabı:** Numex ürünlerinin "nedir?" sayfaları tek yerde.
+- **Bağlantılı:** Üst menüden **Market** ve **Forge**'a geçiş.
+
+---
+← [Ürünler](README.md)

urunler/15-numex-ailesi.md

@@ -0,0 +1,81 @@
+# 👨‍👩‍👧‍👦 Numex Ailesi
+
+🔗 **[numexai.com.tr/aile](https://www.numexai.com.tr/aile)**
+
+> **Tek bir akıl, birçok kapı. Aracın değil, yoldaşın.**
+> *Biz bir aileyiz.*
+
+**NUMEX — İnsanı önce koyan Türk yapay zekâsı.**
+
+```mermaid
+flowchart TB
+    N["<b>NUMEX</b><br/>İnsanı önce koyan Türk yapay zekâsı"]
+    C["🔶 <b>Core — Beyin</b><br/>Hepsinin arkasındaki akıl — kod ve uygulama üretir"]
+    N --> C
+
+    subgraph U["🟢 Uygulamalar · HERKES"]
+      U1["Numex — Sohbet & asistan"]
+      U2["Okul — Doğrulanmış testler"]
+      U3["Codex — Kod editörü"]
+      U4["Market — Hazır uygulamalar"]
+    end
+    subgraph G["🔶 Geliştirici Araçları · YAZILIMCI"]
+      G1["CLI — Terminalden"]
+      G2["SDK — Uygulamana göm"]
+      G3["API — Uzaktan bağlan"]
+    end
+    subgraph P["🟢 Platform & Topluluk · GELİŞTİRİCİ"]
+      P1["Hub — Keşfet & çatalla"]
+      P2["Forge — Kod deposu (Git)"]
+      P3["Numexpedia — Türkçe ansiklopedi"]
+      P4["Oyun Bahçesi — 7'den 70'e oyunlar"]
+    end
+    C --> U & G & P
+
+    subgraph A["Aynı ekipten"]
+      A1["Pusulam — Ön muhasebe & POS"]
+      A2["PC Doktoru — Windows bakım"]
+    end
+```
+
+## Aile üyeleri
+
+### 🟢 Uygulamalar — *herkes için*
+| Üye | Rol | Sayfa |
+|---|---|---|
+| **Numex** | Sohbet & asistan | [→](01-numex-ai-platform.md) |
+| **Okul** | Doğrulanmış testler | [→](11-numex-okul.md) |
+| **Codex** | Kod editörü | [→](03-numex-codex-ide.md) |
+| **Market** | Hazır uygulamalar | [→](13-numex-market.md) |
+
+### 🔶 Geliştirici Araçları — *yazılımcı için*
+| Üye | Rol | Sayfa |
+|---|---|---|
+| **CLI** | Terminalden | [→](02-numex-cli.md) |
+| **SDK** | Uygulamana göm | [→](05-api-ve-sdk.md) |
+| **API** | Uzaktan bağlan | [→](05-api-ve-sdk.md) |
+
+### 🟢 Platform & Topluluk — *geliştirici için*
+| Üye | Rol | Sayfa |
+|---|---|---|
+| **Hub** | Keşfet & çatalla | [→](06-hub-ve-forge.md) |
+| **Forge** | Kod deposu (Git) | [→](06-hub-ve-forge.md) |
+| **Numexpedia** | Türkçe ansiklopedi | [→](14-numexpedia.md) |
+| **Oyun Bahçesi** | 7'den 70'e oyunlar | [→](16-oyun-bahcesi.md) |
+
+### 🤝 Aynı ekipten
+| Üye | Rol | Sayfa |
+|---|---|---|
+| **Pusulam (PusulamX)** | Ön muhasebe & POS | [→](10-pusulamx.md) |
+| **PC Doktoru** | Windows bakım | [→](09-pc-doktoru.md) |
+
+## "Tek akıl" ne demek?
+
+Ailedeki her ürün aynı **Core — Beyin** üzerinde çalışır. Codex'te yazdığınız proje Forge'a gider,
+Hub'da çatallanır, Market'te yayınlanır; Okul'daki çift doğrulama, sohbetteki Detective Mode ile aynı
+fikirden doğar. **Tek hesap** (Google/GitHub) ile hepsine girilir.
+
+*powered by numexai*
+
+---
+← [Ürünler](README.md)

urunler/16-oyun-bahcesi.md

@@ -0,0 +1,10 @@
+# 🎮 Oyun Bahçesi — 7'den 70'e Oyunlar
+
+Numex Ailesi'nin **Platform & Topluluk** kolunda yer alan oyun alanı: **7'den 70'e** herkes için oyunlar.
+
+- Oyunlar, Numex Çekirdeği'nin **otonom ürettiği** tarayıcı ve masaüstü oyunlarıyla aynı üretim
+  hattından gelir (bkz. [Numex Market → Oyunlar](13-numex-market.md)).
+- Codex'te **Oyun** proje türü seçilerek kendi oyununuzu da üretebilirsiniz.
+
+---
+← [Ürünler](README.md) · [Numex Ailesi](15-numex-ailesi.md)

urunler/17-marka-kimligi.md

@@ -0,0 +1,78 @@
+# ✴️ Numex Marka Kimliği — Logonun Gizli Sırrı
+
+*Numex AI — Marka Kiti v2.0 · 2026*
+
+![Numex ana logo](../gorseller/marka-logo.png)
+
+## 🔄 İki kimlik, tek sembol
+
+![Logonun gizli anlamı: normal — AI sembolü; 180° — Selçuklu yıldızı](../gorseller/marka-gizli-anlam.png)
+
+> *"Normal bakışta gördüğünüz modern AI sembolünü 180° döndürün. Anadolu'nun 900 yıllık geometrik
+> mirası karşınıza çıkacak. İki kimlik, tek sembol. Türk zekası ile yapay zekanın birleşimi."*
+
+Numex logosu normal bakışta **modern bir yapay zeka sembolüdür** — merkezdeki göz, nöral ağ
+çizgileri, teknoloji. Logo **180° çevrildiğinde** Anadolu'nun kadim geometrisi ortaya çıkar:
+**Selçuklu mimarisinin 8 köşeli yıldızı**. Sitede logonun üzerine gelince (hover) bu dönüşü canlı
+izleyebilirsiniz. Numex CLI açılışında da aynı sembol görünür: *"◆ Selçuklu yıldızı · İki kimlik, tek sembol"*.
+
+## Neden Selçuklu yıldızı?
+
+| Neden | Açıklama |
+|---|---|
+| 📐 **Geometrik mükemmellik** | 8 köşeli yıldız tam eksensel simetriye sahiptir; 0°, 45°, 90° ve 180° dönüşlerde dengesini korur — logo her dijital ortamda tutarlıdır. |
+| 🏛️ **Kültürel derinlik** | Selçuklular Anadolu'ya matematik, astronomi ve mimari getirdi; Konya, Sivas ve Erzurum medreseleri dönemin bilim merkezleriydi. Yapay zekanın temeli olan hesaplama ve bilimi Türk kültürüyle özdeşleştiren bilinçli bir seçim. |
+| 🎯 **Stratejik farklılaşma** | Hilal, tuğra ve Osmanlı motifleri sık kullanılır; Selçuklu geometrisi az bilinen, sofistike ve özgün bir referanstır. Bilen için derin anlam, bilmeyen için merak. |
+| 🌍 **Evrensel dil** | 8 köşeli yıldız Bizans sanatında, Hint mimarisinde, Avrupa gotiğinde de görülür — yerli bir platformun küresel bir dil konuşmasını sağlar. |
+
+## Logo anatomisi
+
+| Öğe | Anlam |
+|---|---|
+| ⚪ **Merkez nokta (beyaz göz)** | Veri, görme ve yapay zekânın zekâsı |
+| ➕ **4 eksen çizgisi** | Devre kartı ve nöral ağ referansı — dijital teknoloji hissi |
+| ✴️ **8 köşeli yıldız gövdesi** | Normalde soyut AI sembolü; 180° çevrilince Selçuklu yıldızı |
+| 🌊 **Teal → lacivert gradyan** | Teknoloji (teal) ile güven ve derinlik (lacivert) dengesi |
+
+## Varyantlar
+
+![Renk varyantları: Koyu, Teal, Açık, Osmanlı Altın](../gorseller/marka-varyantlar.png)
+
+- **Renk temaları:** Koyu · Teal · Açık · **Osmanlı Altın** (kurumsal ve premium iletişim)
+- **İkon boyutları:** 16 · 24 · 32 · 48 · 64 · 96 px
+- **Kullanım senaryoları:** Yatay logo (koyu/açık) · App ikonu · Minimal wordmark · Chip logo · Outline logo
+- Her varyant **SVG, PNG ve PDF** olarak indirilebilir.
+
+## Renkler
+
+![Marka renkleri](../gorseller/marka-renkler.png)
+
+| Renk | Hex | Anlam |
+|---|---|---|
+| **Ana Teal (Logo)** | `#00C9A7` | Teknoloji, tazelik, inovasyon — tek standart vurgu rengi |
+| **Lacivert** | `#0A1628` | Güven, derinlik, prestij |
+| **Osmanlı Altını** | `#C9A237` | Kurumsal ve premium iletişim |
+| Accent Blue | `#3D9EFF` | Arayüz vurgusu |
+| Accent Purple | `#8B6FFF` | Arayüz vurgusu |
+| Background | `#0D1117` | Arka plan |
+| Surface | `#161B22` | Kart / yüzey |
+| Text Primary | `#E6EDF3` | Metin |
+
+## Yazı tipleri
+
+![Yazı tipleri](../gorseller/marka-yazi.png)
+
+| Kullanım | Font | Ağırlık |
+|---|---|---|
+| Logo, başlık, hero | **Syne** | 700 / 800 / 900 |
+| Arayüz (numexai.com.tr) | **Outfit** | 300 / 400 / 500 / 600 / 700 |
+
+## Doğru kullanım
+
+✅ Koyu zemin üzerinde standart kullanım · ✅ Minimum boyut kuralı · ✅ SVG formatını tercih etmek
+❌ Renkleri değiştirmek · ❌ Eğmek / oranını bozmak · ❌ Karmaşık zeminler üzerinde kullanmak
+
+Marka kiti ve lisans için: **destek@numexai.com.tr**
+
+---
+← [Ürünler](README.md)

urunler/README.md

@@ -0,0 +1,23 @@
+# 🧩 Numex Ürün Ailesi
+
+| # | Ürün | Kategori |
+|---|---|---|
+| 01 | [Numex AI Platform (Web & PWA)](01-numex-ai-platform.md) | Son kullanıcı |
+| 02 | [Numex CLI](02-numex-cli.md) | Geliştirici |
+| 03 | [Numex Codex — Web, IDE, VS Code](03-numex-codex-ide.md) | Geliştirici |
+| 04 | [Numex Core (Corey) — ajan motoru](04-numex-core.md) | Çekirdek |
+| 05 | [Developer API & Codex SDK](05-api-ve-sdk.md) | Geliştirici / B2B |
+| 06 | [Numex Hub & Forge](06-hub-ve-forge.md) | Geliştirici |
+| 07 | [DeepView™](07-deepview.md) | Teknoloji |
+| 08 | [Türkçe karakter sistemi](08-karakterler.md) | Son kullanıcı |
+| 09 | [PC Doktoru Süper Ajan](09-pc-doktoru.md) | Windows |
+| 10 | [PusulamX](10-pusulamx.md) | KOBİ |
+| 11 | [Numex Okul](11-numex-okul.md) | Eğitim — doğrulanmış testler |
+| 12 | [Güvenlik, gizlilik ve KVKK](12-guvenlik-kvkk.md) | Kurumsal |
+| 13 | [Numex Market](13-numex-market.md) | Herkes — 44 açık kaynak uygulama |
+| 14 | [Numexpedia](14-numexpedia.md) | Herkes — Türkçe ansiklopedi |
+| 15 | [Numex Ailesi](15-numex-ailesi.md) | Ekosistem haritası |
+| 16 | [Oyun Bahçesi](16-oyun-bahcesi.md) | Herkes |
+| 17 | [Marka kimliği — Selçuklu yıldızı](17-marka-kimligi.md) | Marka |
+
+← [Ana sayfa](../README.md)