Repertuar — Yetenek Bilgi Tabanı

30 Saniyede

Repertuar, ekibin müşteri projelerinde geliştirdiği çözümleri ve bunlardan damıtılan yeniden kullanılabilir yetenekleri tek yerde toplayan iç bilgi tabanı. Bir stratejist ya da proje yöneticisi, yeni bir teklif düşünürken “benzerini daha önce çözdük mü?” sorusuna saniyeler içinde yanıt bulur. İçerik Obsidian’da yazılır, otomatik yayınlanır; site Google girişiyle korumalıdır; içeriği bir LLM’e taratmak için tek-seferlik bağlantı üretilebilir.

İş Problemi & Fırsat

Ajans/yazılım ekipleri aynı çözümü (giriş, raporlama, medya, bildirim…) farklı müşterilerde tekrar tekrar yazar ama bu birikim dağınık kalır: kimsenin aklında tam ne yapıldığı, neyin taşınabilir olduğu durmaz. Sonuç: tekrar eden iş, kaçan satış fırsatı, “bunu zaten yapmıştık” deyip bulamamak. Fırsat: bu birikimi aranabilir, bağlantılı ve ilham veren bir vitrine çevirmek — hem ekip içi verimi hem de teklif hızını artırır.

Kullanıcı Deneyimi

Kullanıcı siteye Google ile girer (sadece izinli ekip). Anasayfada projeler ve yetenekler kart vitrini olarak karşısına gelir; her kartta tek cümlelik değer önerisi vardır. Üstteki arama ile içeriği tarar, etiketlere tıklayıp filtreler, sağdaki graph ile bağlantıları keşfeder. Bir notta “Yeniden Kullanılabilir Yetenekler” bölümündeki bağlantılar onu doğrudan ilgili yeteneğe götürür. Kendi LLM’ine tüm içeriği taratmak isterse “LLM Erişimi”nden bir kerelik bağlantı üretir.

Sahibin Amacı / Vizyon

Amaç sadece bir doküman arşivi değil; sinerjiyi görünür kılan bir araç. O yüzden her not “önce iş değeri, sonra teknik” mantığıyla yazılır (bkz. üretim prompt’u) ve stratejiste hitap eder. Yayın sürtünmesiz olmalı (Obsidian’da yaz, gerisi otomatik); erişim güvenli ama hafif olmalı (sunucuya dokunmadan SSO). Uzun vade: ekibin “kurumsal hafızası” + tekliflerde kullanılan bir ilham kaynağı.

Nasıl Çalışır (sade)

1. İçerik Obsidian’da Repertuar/ klasöründe yazılır.
2. Obsidian Git push edince, otomatik bir tetik siteyi günceller (anında).
3. Site bir static-site üreticisiyle (Quartz) yeniden kurulur ve yayınlanır.
4. Cloudflare, siteyi Google girişiyle korur; sadece izinli e-postalar girer.
5. Bir uç servisi (Worker), LLM’ler için tek-seferlik/süreli içerik bağlantısı verir.

Teknik özet: iki GitHub repo (vault + site), GitHub Actions event-driven sync, Docker+Coolify deploy, Cloudflare Access + Workers/KV.

Yeniden Kullanılabilir Yetenekler

• event-driven-icerik-sync — Bir kaynakta değişiklik olunca (push) içeriği anında otomatik yayınlar. İçerik/CMS akışı olan her projeye taşınır.
• cloudflare-access-sso — Bir siteyi sunucuya dokunmadan Google SSO + e-posta allowlist arkasına alır. Hızlı “private site” gereken her yerde hazır.
• edge-worker-token-gate — Edge’de tek-seferlik/süreli token ile korunan içerik/API erişimi. “LLM’e ya da partnere geçici erişim ver” senaryosuna birebir.
• admin-allowlist-paneli — Giriş yetkisini admin’in arayüzden düzenlemesi. Çok kullanıcılı her üründe erişim yönetimi.
• build-zamani-icerik-dogrulama — Bozuk içerik deploy’u build’de patlatır, canlı site düşmez. Dayanıklı statik yayın isteyen her projede.
• llms-icerik-paketi — Tüm içeriği tek dosyada LLM/RAG’e sunar. “İçeriğimi yapay zekâya taratayım” diyen her projede.

İş Etkisi / Sonuç

Canlıda (repertuar.ahmetgo.com), Rhino Runner ekibi kullanıyor. İlk içerik: ENport ve AI Pulse projeleri + ~17 yetenek notu. Yayın akışı uçtan uca otomatik; SSO ve LLM-erişim çalışır durumda. [?] Kullanım metrikleri henüz toplanmıyor.

Ekran görüntüleri

• — Kart vitrini anasayfa
• — Not sayfasındaki künye kartı
• — Arama modalı
• — LLM Erişimi token sayfası
• — Admin allowlist paneli

Teknik Detaylar (geliştiriciler için)

• İçerik kaynağı: ahmetgon/obsidian vault (Repertuar/). Site: ahmetgon/repertuar (Quartz v5, content/ sync’le doldurulur).
• Sync: obsidian repo’sunda on: push workflow → repertuar sync-obsidian.yml’i workflow_dispatch’le tetikler → scripts/sync-content.mjs (içerik + anasayfa vitrini) + scripts/gen-llms.mjs (llms-full.txt) → commit → deploy. (GitHub schedule cron’una güvenilmez; bu yüzden event-driven.)
• Deploy: Docker (multi-stage; builder’da RUN npx quartz build ile içerik doğrulanır) → Coolify (Hetzner).
• Auth: Cloudflare Access (Google IdP, e-posta allowlist, ACME bypass ile cert korunur). Origin’e dokunulmaz.
• Worker: repertuar-api (KV) — /llms (token UI), /api/llms (tek-seferlik servis), /ayarlar (admin allowlist).

Tekrar Kullanım Notları

Strateji: Bu mimari herhangi bir “Obsidian/markdown → korumalı, otomatik yayınlanan iç site” ihtiyacına doğrudan taşınır (playbook’lar, runbook’lar, müşteri wiki’leri). SSO + LLM-erişim parçaları başka projelerde tek başına da kullanılır. Teknik: Cloudflare Access proxy gerektirir (cert için ACME bypass şart). Worker’daki API token dar yetkili olmalı. Quartz runtime’da build ettiği için container başlangıcı yavaş — istenirse prebuilt-statik servise geçilebilir.