Packages/RbnPipeline — yapay zekâ içerik hattı (prompt kuralları, preset'ler, otomasyon)

Doğrulanan kod tabanı: d49b4413 (dal feat/fw-license-master) · Tarih: 2026-10-05 · Yayın: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kaynak klasör: Packages/RbnPipeline/ — 31 *.php
(3 Builders/ + 3 Builders/Tasks/ + 4 Concerns/ + 2 Contracts/ +
6 Presets/ + 3 Rules/Blog/ + 7 Rules/Prompt/ + 1 Rules/Youtube/ + 2 Services/).
Envanter: 31 dosyanın 31'i aşağıda anlatıldı.
Bu paket spek eşiğini (≥20 php) aştığı için alt dal belgeleri de üretildi:
Rules.md.

1. Ne işe yarar, kim kullanır

"RSS/Trends'ten haber al → yapay zekâ ile metin üret → görsel üret → taslak
kaydet → yayınla → sosyal medyaya dağıt" zincirinin tamamıdır. Tasarım
kural tabanlıdır: her beceri (Rules/) küçük bir sınıftır, her hazır
kombinasyon (Presets/) bu kuralları birleştirir, PromptBuilder hepsini
tek metne derler.

Kimler çağırır: cron/queue motoru → Builders/Tasks/* (görev sınıfları) →
AbstractTaskBuilder::autopilot() → Services/AutoTaskManager.php ve
Services/ExternalFetchManager.php (PackageData.php:44).

2. Alt klasör haritası

3. Klasör/dosya envanteri (31/31)

3.1 Builders/ (3)

3.2 Builders/Tasks/ (3)

3.3 Concerns/ (4)

3.4 Contracts/ (2)

3.5 Presets/ (6)

3.6 Rules/ (11) — ayrıntılı liste Rules.md

3.7 Services/ (2)

Kapsama: 31/31.

4. Akış

4.1 Otomatik görev (cron → yayın)

Cron/queue motoru → ContentTaskBuilder::autopilot($params)   AbstractTaskBuilder.php:37
 ├─ 1) category_type türetilir (params → preset adı)          :45-51
 ├─ 2) ZORUNLU parametre denetimi                             :54-59
 │     project_key yok  → CronTaskException::missingParameter
 │     local_model yok  → CronTaskException::missingParameter
 ├─ 3) executeAutopilot($taskParams)                          :62
 │     ├─ resolveCandidate()                        (1. adım) :87
 │     │    ├─ source 'trends' → fetchTrendsCandidate()       :105-106
 │     │    ├─ source 'rss'    → fetchRssCandidate()          :107-108
 │     │    ├─ hiçbiri değilse fetchDraftCandidate()          :111-113
 │     │    └─ aday yoksa → CronTaskException::candidateNotFound  :115-121
 │     │        (taskLog->skipped() ile "atlandı" olarak loglanır)
 │     ├─ buildContext()                             (2. adım) :142
 │     │    taskParams + generation_options + categories + eski haberler
 │     ├─ generateText()   → service('app.gemini')            :249
 │     │    AutoTaskManager::generateText()                   AutoTaskManager.php:23
 │     │    ├─ yayınlanmış yazılar + kategoriler bağlama eklenir  :41-61
 │     │    ├─ $geminiApp->generateText($type,$title,$context)   :64
 │     │    ├─ normalizeAiResponse()                              :73
 │     │    └─ formatFaqs()                                       :76
 │     ├─ generateImage()  → FileService (Packages/RbnFile)  :288
 │     ├─ savePost()       → taslak kayıt                    :274
 │     ├─ finalizePost()   → publishPost()                   :308
 │     │    ├─ publishPost()                                   AutoTaskManager.php:263
 │     │    ├─ clearSitemapCache() / clearFeedCache() / clearContentCache()  :316-318
 │     │    └─ resolvePublishedPostLink(..., asHtmlLink=false)               :371
 │     └─ dispatchSocialShares() → Facebook + Instagram       :376, 386
 └─ CronTaskException yakalanır → success=true + status döner  :63-69

Kritik davranış: CronTaskException hata değildir; görev "atlandı"
olarak başarıyla kapanır (success=true, status dolu) — böylece cron
motoru bunu hata saymaz (:63-69).

4.2 Prompt derleme

PromptBuilder
 ├─ json($schema)?  → JsonResponseRule (aynı sınıf ikinci kez eklenmez)
 │                    applyRule() sınıf bazlı tekilleştirme yapar  PromptBuilder.php:28
 ├─ seo() / image() / innerLinking() / …  → ilgili kural sınıfı
 ├─ preset('blog') → BlogPreset::apply($this)   (kuralları tek tek ekler)
 ├─ task('...')    → görev metni
 ├─ withContext([...]) → context
 ├─ compile()      → kuralların compileInstructions() + görev metni
 └─ sanitize($response) → kuralların sanitizeResponse() zinciri

4.3 Dış kaynak aday toplama

ExternalFetchManager::fetchRssCandidate($params)
 ├─ service('rssParser')->parse($url)            RbnUtility
 ├─ getBlacklistedGuids($projectKey)              → daha önce işlenenler
 ├─ getExistingGuids($modelAlias, $projectKey)    → sitede yayınlananlar
 ├─ getPublishedTitles($modelAlias, 200)          → başlık benzerliği
 └─ filterUniqueCandidates($candidates, ...)      → kalan adaylar

5. Yapılandırma / ayar anahtarları

6. Tuzaklar ve kurallar

1. Aynı kural iki kez eklenmez. applyRule() sınıf adına göre tekilleştirir
   (PromptBuilder.php:30) — image() ve imagePrompt() aynı
   ImagePromptRule sınıfını ekler, ikinci çağrı yok sayılır.
2. Aday bulunamazsa hata fırlatılmaz. CronTaskException::candidateNotFound
   atılır ve autopilot() bunu success=true + status ile karşılar
   (:115-121, :63-69). Bu, "bugün yeni içerik yok" durumunu hata gibi
   göstermemenin yoludur.
3. Zorunlu parametre denetimi baştan yapılır (:54-59); yarım kalan
   görev yarım içerik üretmez.
4. Kategori hiyerarşisi: görev içinde category_type açıkça verilmişse
   o kazanılır; verilmemişse preset adından türetilir (:45-51).
5. Yayın sonrası üç önbellek temizlenir — sitemap, feed, içerik
   (AutoTaskManager.php:316). Biri unutulursa yeni yazı sitemap'te
   görünmez.
6. resolvePublishedPostLink(..., $asHtmlLink) bayrağı belirleyicidir:
   false ile ham URL alınır ve sosyal caption'a konur (:371).
7. JSON onarımı merkezidir: SanitizesResponseTrait::cleanJsonWrapper/ repairJson/extractBalancedJson tüm framework'te tek kopyadır; kural
   sınıfları kendi kopyasını yazmaz, bu trait'i kullanır.
8. ContentQualityRule "AI slop" karşıtıdır; metin üretimi sonrası
   sanitize aşamasında devreye girer — üretilen içeriği olduğu gibi
   yayınlamak bu kuralın varlık nedenidir.

7. Örnek (gerçek koddan)

// Prompt derleme
$prompt = $this->builder('prompt')
    ->json(['baslik' => 'string', 'icerik' => 'string'])
    ->seo()
    ->blogStructure()
    ->identity()
    ->preset('blog', $context)
    ->task('Türkçe bir blog yazısı yaz.')
    ->withContext($context)
    ->compile();

$metin = $prompt->sanitize($aiYanit);

8. İlgili belgeler

• RbnPipeline/Rules.md — 11 kural sınıfının ayrıntılı listesi
• PackageData.md — rules.*, presets.*, builders.* kayıt adları
• RbnApi.md — app.gemini, FacebookService, InstagramService, rssParser tüketicisi
• RbnUtility.md — RSS ve Google Trends kaynakları
• RbnFile.md — görsel üretimi sonrası depolama
• Core/Services (../Core/Services/) — cron/queue motoru (⏳ ayrı görev; belgesi henüz yazılmadı)