Makdos AI Agency OS

Makdos AI, ajansların ve birden fazla müşteriye hizmet veren işletmelerin yapay zekâ ile çalışan operasyonlarını tek bir panelde yönetmesi için ekip olarak geliştirdiğimiz, sektörden bağımsız bir platform. Kendimize verdiğimiz tanımla bir "Agency OS", yani ajanslar için bir işletim sistemi. Kullanıcı tek tek yapay zekâ araçlarının arasında dolaşmıyor; bir iş başlatıyor ve sistem bu işi ajanlara ve araçlara bölerek yürütüyor. Proje birden fazla geliştiricinin birlikte çalıştığı bir ekip projesi ve ben de bu ekibin bir üyesiyim.

Amaç

Bir ajansın günlük işi çok parçalı. Müşteriler için sosyal medya içeriği planlanıyor, metinler yazılıyor, görseller ve videolar hazırlanıyor, bunlar önce ajans içinde sonra müşteri tarafından onaylanıyor ve en sonunda yayına alınıyor. Aynı zamanda müşterilerden gelen mesajlara yanıt veriliyor, randevular ve potansiyel müşteriler takip ediliyor. Bu işlerin her biri için ayrı bir araç kullanmak hem zaman kaybettiriyor hem de markanın sesini ve görsel dilini korumayı zorlaştırıyor.

Makdos AI'ı bu dağınıklığı tek bir yerde toplamak için tasarladık. Platformun temel ilkesi "önce iş" yaklaşımı. Her üretim bir işe bağlı oluyor, her iş belirli aşamalardan geçiyor ve her adımın kim tarafından, hangi sürümle ve ne maliyetle yapıldığı kayıt altında tutuluyor.

Nasıl çalışır

Sistemin omurgasında beş temel kavram var. Müşteri, ajans içindeki bir markanın çalışma alanını temsil ediyor. İş, sıraya alınan, çalışan, incelemeye giren, onaylanan, yayınlanan ve raporlanan bir iş emri. Çıktı, bir işin ürettiği ve sürümlenen metin, görsel, video, ses ya da rapor. Onay, kimin hangi sürümü hangi kanal için ne zaman onayladığını tutan kayıt. Maliyet kaydı ise her adımda hangi modelin ne kadar token harcadığını ve bunun ne kadara mal olduğunu gösteriyor.

İçerik iki aşamalı bir onaydan geçiyor. Önce ajans içeriğin marka ile uyumlu ve müşteriye gösterilebilir olup olmadığına karar veriyor. Ardından içerik müşterinin onayına sunuluyor ve son söz müşteride oluyor. Her iki aşamada da revizyon istenebiliyor. Yayın, içeriğin onaylanan sürümüne bağlı; sonradan değiştirilmiş bir içerik eski onayla yayına çıkamıyor.

Marka hafızası platformun merkezinde duruyor. Her müşteri için markanın sesi, renkleri, yazı tipleri, logoları, örnek paylaşımları ve görsel tarzı burada tutuluyor. Müşteriye ait belgeler bir bilgi tabanına yükleniyor ve içerik üretilirken ilgili bölümler PostgreSQL'in tam metin aramasıyla seçilip bağlama ekleniyor.

Öne çıkan özellikler

• İçerik takvimi müşterinin markasına, kaynaklarına ve özel günlere göre aylık paylaşım planı hazırlıyor ve kalemleri otomatik olarak üretebiliyor.
• İçerik metni kaynağa bağlı yazılıyor. Kaynakta bulunmayan gerçek bir bilgi uydurulmuyor; eksik bilgi olduğunda içerik "Bilgi Bekliyor" durumunda kalıyor ve kullanıcıya soruluyor.
• AI Studio, görsel, video ve kısa film gibi çıktılar için serbest bir üretim atölyesi sunuyor.
• Markaya ait SVG şablonları içe aktarılabiliyor. Yapay zekâ tasarımı baştan çizmiyor; şablonun içindeki alanları dolduruyor, başlık ve metinler ise gerçek yazı tipleriyle sunucuda basılıyor.
• Panelde, kullanıcıların tasarımı katmanlar, yazı tipleri ve renkler üzerinden serbestçe düzenleyebildiği bir Canvas editörü bulunuyor.
• Karusel paylaşımlar kapak, iç ve kapanış sayfalarından oluşan tek bir içerik olarak üretiliyor.
• Üretilen her görsel, anlam, yerleşim ve çıktı başlıklarında kalite kontrollerinden geçiyor ve bir tasarım puanı alıyor; puan düşükse sistem hedefli düzeltmeler deniyor.
• Birleşik gelen kutusu farklı kanallardan gelen mesajları bir araya topluyor. Her konuşma için tam otomatik, yarı otomatik ya da elle yanıt kipi seçilebiliyor ve operatör istediği an konuşmayı devralabiliyor.
• Otomatik yanıt bilerek dar tutuldu. Yapay zekâ yalnızca selamlaşma ve teşekkür mesajlarını kendisi yanıtlıyor; teknik, fiyat, randevu ya da şikâyet içeren her mesaj bir insana bırakılıyor.
• Panelde randevular, kişiler, potansiyel müşteri listeleri, Google reklam ve analiz araçları, canlı destek ve raporlama bölümleri de bulunuyor.

Güvenlik

Platform çok kiracılı (multi-tenant) olarak çalışıyor. Her ajansın verisi diğerlerinden yalıtılıyor ve bu yalıtım ayrıca denetlendi. Ajans ve müşterilere ait hiçbir bilgi yapılandırma dosyalarında tutulmuyor; tamamı veritabanında duruyor ve hassas alanlar şifreleniyor. Yapay zekâ sağlayıcılarının API anahtarları şifreli bir kasada saklanıyor. Erişim, kullanıcı bazında tanımlanan yüzey izinleriyle sınırlanıyor ve iki adımlı doğrulama destekleniyor. İş kayıtları hiçbir zaman kalıcı olarak silinmiyor; pasife alınıyor ve gerektiğinde geri getirilebiliyor.

Yapay zekâ kullanımı da kayıt altında. Gerçek sağlayıcıya yapılan her çağrı ortak bir kullanım defterine tek satır olarak yazılıyor. Maliyeti bilinmeyen bir çağrı sıfır olarak kaydedilmiyor. Görsel ve video üretim işleri için bir bütçe sınırı uygulanabiliyor.

Teknik altyapı

Proje tek bir depoda dört platform olarak geliştiriliyor: tanıtım sitesi, ana panel, yönetim paneli ve mobil uygulamalar. Bütün arka uçlar Go ile ve Fiber çatısıyla yazıldı. Veritabanı PostgreSQL, önbellek Valkey. Web arayüzleri Vite, React ve TypeScript ile, Tailwind CSS kullanılarak geliştirildi; sunucu verisi TanStack Query ile yönetiliyor. Canvas editörü React 19 ve Konva ile yazılmış ayrı bir Vite uygulaması. Mobil tarafta Android için Kotlin ve Jetpack Compose, iOS için Swift ve SwiftUI kullanılıyor.

Görsellerin son basımı Go ile yazdığımız deterministik bir basım motorunda yapılıyor. Aynı yerleşim hesapları hem tarayıcıdaki editörde hem de sunucuda ortak test vektörleriyle doğrulanıyor; böylece editörde görülen tasarım ile sunucunun ürettiği görsel birebir aynı çıkıyor. Panel ile sunucu arasındaki ilerleme bilgisi WebSocket üzerinden anlık olarak iletiliyor.

Platform birden fazla yapay zekâ sağlayıcısıyla çalışabiliyor ve hangi metin modelinin kullanılacağı görev bazında belirleniyor. Sunucularda Docker kullanılmıyor, her servis bir systemd birimi olarak çalışıyor. Sunuculara kaynak kod gönderilmiyor; yalnızca derlenmiş Go ikilileri ve arayüzlerin derleme çıktıları taşınıyor. Her derleme tarih ve saatten oluşan benzersiz bir sürüm numarası alıyor.

Kullanım alanları

• Birden fazla markanın sosyal medya içeriğini yöneten dijital ajanslar.
• Klinik, otel, e-ticaret ya da kurumsal şirketler gibi çok müşterili veya çok şubeli işletmelerin içerik ve iletişim operasyonları.
• Marka kurallarına uygun görsellerin şablonlardan hızlı ve tutarlı biçimde üretilmesi.
• Müşteriden gelen mesajların tek bir gelen kutusunda toplanması ve güvenli sınırlar içinde yapay zekâ desteğiyle yanıtlanması.
• Yapay zekâ harcamalarının iş, müşteri ve model bazında izlenmesi.

Durum

Platformun içerik takvimi, marka hafızası, şablonlu görsel üretimi ve Canvas editörü yayında ve kullanılıyor. Diğer modüller üzerinde geliştirme devam ediyor.