# ASTROBİLGE SİSTEM KONTROL VE MİMARİ CHECKPOINT RAPORU
**Tarih:** 04 Eylül 2026  
**Durum:** Üretim Seviyesi / Tam Entegre & Arka Planda Aktif  
**Sürüm Etiketi:** `checkpoint-ai-reasoning-library-2026-09-04`

---

## 1. GENEL BAKIŞ VE HEDEF
Bu doküman; AstroBilge platformunun yapay zeka çıkarım motoru (AI Reasoning Engine), sohbet ve mantık yürütme algoritmaları (Chat & Synthesizer), halüsinasyon önleme katmanı (Hallucination Guard), astrolojik bilgi kütüphaneleri ve 1.300+ kitaplık otonom döküman işleme altyapısının kalıcı kontrol noktasıdır (checkpoint).

Tüm sistem, yapay zekanın genel geçer tahminler yerine **doğrulanmış astrolojik kurallar ve otorite kitaplar üzerinden milisaniyeler içinde çıkarım yapmasını** sağlamak üzere tasarlanmıştır.

---

## 2. YAPAY ZEKA VE MANTIK YÜRÜTME ALTYAPISI (AI REASONING STACK)

### A. Soru Sınıflandırma Motoru (`QuestionTopicClassifierService`)
* **Dosya:** `app/Services/Ai/QuestionTopicClassifierService.php` & `TopicClassificationResult.php`
* **İşlev:** Kullanıcının sorusunu analiz ederek niyet ve astrolojik odak alanını belirler (Aşk/Sinastri, Kariyer/Finans, Sağlık/Medikal, Transit/Öngörü, Ruhsal/Karmik, Rektifikasyon vb.).
* **Çıktı:** Konu etiketi, hedef gezegenler, açılar ve gerekli kural filtreleri.

### B. Harita Dilimleme Motoru (`ChartDataSlicerService`)
* **Dosya:** `app/Services/Ai/ChartDataSlicerService.php`
* **İşlev:** Doğum haritasındaki yüzlerce gösterge arasından sadece sorulan soruyla doğrudan ilişkili olanları (ilgili gezegenler, ev yöneticileri, açılar ve sabit yıldızlar) dilimler (token optimizasyonu).

### C. Çok Katmanlı Mantık Yürütme Motoru (`AstrologicalReasoningEngine`)
* **Dosya:** `app/Services/Ai/AstrologicalReasoningEngine.php`
* **İşlev:** Dilimlenen harita verileri ile veritabanındaki kuralları birleştirir. Gezegen asaletlerini (yücelim, düşüş, zarar), ev konumlarını ve açı dinamiklerini mantıksal bir sıra ile değerlendirir.

### D. Halüsinasyon Önleme Kalkanı (`AstrologicalHallucinationGuardService`)
* **Dosya:** `app/Services/Ai/AstrologicalHallucinationGuardService.php`
* **İşlev:** Üretilen yapay zeka çıktısının haritada gerçekten var olan açılara ve veritabanı kurallarına sadık kalıp kalmadığını denetler. Haritada olmayan bir açının veya konumun uydurulmasını engeller.

### E. Astroloji Sentezleyici (`AstrologicalSynthesizerService`)
* **Dosya:** `app/Services/Ai/AstrologicalSynthesizerService.php` & `AiService.php`
* **İşlev:** Kural tabanlı çıkarımları, otorite yazarların kitaplarındaki derin psikolojik/arketipik yaklaşımlarla harmanlayarak sıcak, profesyonel ve dönüştürücü bir danışmanlık diliyle kullanıcıya sunar.

---

## 3. VERİTABANI VE KÜTÜPHANE ŞEMALARI

### 1. Vaka ve Harita Veritabanı (`biography_cases` & `biography_case_events`)
* **Toplam Vaka:** 45.576 harita (33.855 AA Sınıfı, 10.796 A Sınıfı, 922 B Sınıfı)
* **Toplam Yaşam Olayı:** 70.573 doğrulanmış dönüm noktası (evlilik, kaza, ödül, terfi, ölüm vb.)
* **Özellikler:** Çift dilli (`biography_en`, `biography_tr`, `categories_en`, `categories_tr`), Rodden Rating kalitesi, kesin doğum saatleri ve koordinatlar.

### 2. Astroloji Yorum ve Kural Kütüphanesi (`astrology_interpretations_library`)
* **Toplam Kural:** 934+ atomik kural (Milisaniyelik indeksli)
* **İçerik:**
  - 360 Sabian Sembolü (Marc Edmund Jones & Lynda Hill - Zodyak 1°-360°)
  - 360 Charubel Zodyak Derecesi (Charubel okült dereceleri)
  - Vivian Robson Sabit Yıldızlar ve Gezegen Kavuşumları (Algol, Sirius, Regulus, Spica...)
  - Sakoian, Robert Pelletier ve Betty Lundsted Gezegen Açıları (Venüs-Satürn karesi, quincunx vb.)
  - Temel asalet ve teknik yorum kuralları

### 3. Astroloji Ansiklopedisi (`astrology_wiki_articles`)
* **Toplam Madde:** 1.690 çift dilli astrolojik terim, sembolizm ve teknik analiz makalesi.

### 4. Tam Metin Kitap Kütüphanesi (`astrology_book_library`)
* **Tablo:** `astrology_book_library`
* **Alanlar:** `author`, `book_title`, `chapter_index`, `chapter_title`, `content` (longtext), `word_count`, `detected_topics` (JSON), `file_type`, `source_path`.
* **İndeks:** MySQL Full-Text (`idx_books_fulltext` on `content`, `book_title`, `author`).
* **Kapsam:** 1.301 tam metin kitap (1.258 Word + 43 PDF).

---

## 4. OTONOM ARKA PLAN SERVİSLERİ VE KOMUTLARI

1. **`php artisan solarfire:import`**
   - Solar Fire 9 arşivindeki 42 dosyadaki tüm AA, A ve B haritalarını çift dilli çözen ikili ayrıştırıcı.
2. **`php artisan solarfire:import-interpretations`**
   - Solar Fire 9'un `.int` formatındaki Sabian ve Charubel zodyak derecelerini çözen ayrıştırıcı.
3. **`php artisan astro:import-books`**
   - Vivian Robson, Sophia Mason ve Sakoian kitaplarındaki sabit yıldız ve gezegen açı kurallarını ayrıştıran motor.
4. **`php artisan astro:ingest-all-books --limit=0`**
   - Arka planda kesintisiz çalışan ana işçi (daemon). 1.301 kitabın tamamını bölüm bölüm okur, tam metin olarak `astrology_book_library` tablosuna işler.
   - İlerleme Takibi: `storage/app/astro_books_ingestion_progress.json`.
5. **`php artisan wiki:crawl-astrology`**
   - AstroWiki ansiklopedisini eksiksiz yerel veritabanına aktaran crawler.

---

## 5. KURTARMA VE GERİ DÖNÜŞ (RECOVERY) PROSEDÜRÜ
Herhangi bir sistem güncellemesi veya sunucu taşınması durumunda:
1. `git checkout checkpoint-ai-reasoning-library-2026-09-04` komutu ile tüm kod tabanı anında bu kararlı duruma getirilebilir.
2. `php artisan migrate` komutu ile tüm tablolar ve full-text indeksler otomatik yeniden inşa edilir.
3. Kitap aktarımı kesintiye uğrasa dahi `astro_books_ingestion_progress.json` sayesinde kaldığı kitaptan otomatik olarak devam eder.