Dağıtık projelerin geliştirme süreçlerini, görevlerini ve ilerleme metriklerini tek bir güvenli platformda birleştiren, AI destekli portföy yönetim sistemi.
Şekil 1: Merkezi Proje İzleme Paneli Genel Bakış
Şekil 2: Proje Detayları ve İlerleme Durumları
Şekil 3: İşletme ve Performans Metrikleri
PLANNER-AGENT, birden fazla bağımsız yazılım/SaaS projesinin aynı anda otonom olarak izlenmesini, durum tespitinin yapılmasını ve merkezi bir gösterge panelinde (dashboard) raporlanmasını sağlayan bütünleşik bir sistemdir.
Farklı sistemlerde dağınık halde bulunan proje dosyalarını, ilerleme (progress) yüzdelerini, teknik notları ve yapılacaklar listelerini konsolide eder. Otonom ajanlar vasıtasıyla GitHub API verilerini ve yerel proje durumlarını okuyarak, yöneticilere gerçek zamanlı bir "Executive" (yönetici özeti) bakışı sunar. Geliştirme yaşam döngüsündeki (SDLC) görünürlük eksikliği problemini çözerek veri odaklı karar alma sürecini hızlandırır.
Kurumsal çevik (Enterprise Agile) yönetim modellerinde en büyük darboğaz, çoklu projelerin teknik durumlarının manuel olarak derlenmesidir. Bu proje, süreçleri manuel takip etmek yerine otonom ajan tabanlı bir sistem mimarisi (Agentic System Architecture) kurgulayarak aşağıdaki kurumsal standartları sağlar:
- Otonom Sistemler (Autonomous Agents): Düzenli aralıklarla repoları ve klasörleri tarayıp veri güncelleyen otonom senkronizasyon (sync) ajan altyapısı.
- Kesintisiz Veri Akışı ve Haberleşme: GitHub API'si ile sistem bileşenleri arasındaki token-limitlerini optimize eden asenkron veri haberleşmesi.
- Merkezi Görünürlük (Single Source of Truth): Portföy yöneticileri ve teknik ekipler için tek noktadan çoklu projenin kod metriklerini, görev durumlarını ve başarı yüzdelerini anlık izleme olanağı.
- Modüler ve Güvenli Tasarım: Ajanların yetki sınırları belirlenerek sistem güvenliği ve API güvenlik standartları uygulanmıştır.
Sistem modern, yüksek performanslı ve yatay ölçeklenmeye uygun kurumsal mimari standartlarına göre tasarlanmıştır.
| Kategori | Teknolojiler | Kullanım Amacı / Gerekçe |
|---|---|---|
| Frontend Mimari | Next.js 16 (App Router), React 19, TypeScript | Sunucu Tarafı Oluşturma (SSR) ile hızlı ilk yükleme, güçlü tip güvenliği ve modüler component mimarisi. |
| Arayüz (UI) & Tasarım | TailwindCSS v4, Kurumsal Dark Theme, Glassmorphism | Performanslı, estetik ve minimal yönetici arayüzü; kurumsal standartlara uygun görsel hiyerarşi. |
| Backend & Orkestrasyon | Node.js, Next.js API Routes | Mikroservis mantığıyla ayrıştırılmış, sunucusuz (serverless) mimariye uyumlu otonom uç noktalar (endpoints). |
| AI / Otonom Ajanlar | Özel Prompt Mimari (.agents), Sync Ajanları (Node) | Verileri analiz edip JSON formatlarına çeviren ve GitHub'a senkronize eden akıllı algoritmalar. |
| Veri & Entegrasyon | GitHub REST API, JSON State Yönetimi | Projelerin mevcut durumlarını, repolarını commit/PR verilerini işlemek. |
Sistem, ajan tabanlı bir veri-çekme/işleme hattına (pipeline) oturtulmuştur. Teknik iş akışı aşağıdaki gibidir:
- Veri Kaynağı Taraması (Discovery): Ajan algoritmaları, tanımlı proje klasörlerini veya remote/GitHub versiyon kontrol sistemlerini izler. Mevcut durum dosyalarını (Markdown/JSON vb.) okur.
- Otonom Veri İşleme (Data Processing):
sync_agent.jsve.agentsaltındaki yapılar devreye girerek, okunan ham dokümantasyon (yapılacaklar, biten işler, MRR gibi SaaS KPI'ları vb.) metinlerini ayrıştırır. Projenin genel tamamlanma yüzdesini hesaplar. - Merkezi Mutabakat (State Management): İşlenen tüm bu proje skorlama ve teknik detay bilgileri,
Master-Monitor-master-monitor.jsongibi konsolide veri dosyalarında standardize edilmiş formatta (Structured Data) loglanır. - Sunum Katmanı (Presentation): Next.js ile kurgulanmış Dashboard, asenkron
fetchfonksiyonları ile bu güncel JSON durumlarını ve harici GitHub API entegrasyonlarını kullanarak arayüzü hydrate (render) eder. - Reaktivite: Yöneticiler Dashboard üzerinde projelerin canlı sağlığını (health) izler.
Bu projede sistem güvenilirliğini (reliability) ve performansını artırmak amacıyla uygulanan temel çözümler şunlardır:
- Asenkron API Optimizasyonu (Rate Limiting Yönetimi): Çok fazla projeyi aynı anda izleyen sitemde GitHub API
Rate Limitproblemini aşmak üzere backoff mekanizmaları ve önbellekleme (caching) mimarisi kurgulanmıştır. - Tip Güvenliği (Strict Type-Safety): Proje metrikleri ve ajan verileri arasında oluşabilecek tip uyuşmazlıkları TypeScript interface'leri vasıtasıyla derleme aşamasında (compile-time) engellenmiştir.
- Gelişmiş Durum Yönetimi (State Extraction): Markdown veya düz metin (unstructured) proje verilerinden anlamlı ilerleme yüzdeleri çıkaran, hata toleransına sahip robust parser/regex mimarileri geliştirilmiştir.
- Bölümlenmiş Modüler Derleme: Bağımsız modüllerin (Ajan süreçleri vs. Dashboard frontend) birbirini bloklamaması için mimariler ayrıştırılmış (decoupled) şekilde inşa edilmiştir.
PLANNER-AGENT/
│
├── .agents/ # Sistemin otonom işlem ve analiz ajanlarının prompt/kuralları
│ └── master_monitor_agent.md # Veri senkronizasyonu için ana karar mekanizması
│
├── master-monitor/ # Kullanıcı Arayüzü (Next.js Dashboard Mimarisi)
│ ├── .next/ # Derlenmiş sistem bundle'ları
│ ├── src/
│ │ ├── app/ # Next.js App Router yapısı (API Routes ve Sayfalar)
│ │ ├── components/ # Tekrar kullanılabilir, modüler React UI bileşenleri
│ │ │ └── DashboardClient.tsx # İstemci taraflı interaktif dashboard render motoru
│ │ └── lib/ # Ortak util, yardımcı servis fonksiyonları
│ ├── public/ # Statik asetler
│ ├── package.json # Frontend dependency manifest
│ └── .env.local # Güvenli çevre (environment) değişkenleri konfigürasyonu
│
├── data/ # Kurumsal log ve durum arşivi
│ └── Master-Monitor-master-monitor.json # Konsolide edilmiş tüm projelerin real-time analiz durumu
│
├── sync_agent.js # Terminal/Arka planda çalışan, Otonom GitHub senkronizasyon servisi
├── planner-agent-history.md # Yönetim kararları ve proje gelişim metrikleri (Audit Trail)
└── README.md # (Bu Belge)
Sistemin ölçeklenebilir altyapısı sayesinde planlanan sonraki aşamalar:
- Grafiksel Tahminleme (Predictive Scaling): Geçmiş verilere (velocity) dayalı olarak ekiplere sprint içi bitirme tarihi/efor tahminleri yapan AI katmanları.
- Platform Genişlemesi (CI/CD Entegrasyonu): GitHub Actions veya Jenkins pipeline'ları ile birebir veri alışverişinin sağlanması; derleme hatalarının anlık yansıtılması.
- Üçüncü Parti Uygulama Uyumları: Sınırlandırılmış yetkilere sahip Slack/Discord Webhook haberleşme botlarının entegrasyonu.
- Rol Bazlı Erişim (RBAC): Yönetici (Admin), İzleyici (Viewer) ve Yazılımcı (Developer) standartlarında farklı dashboard yetki kurguları tasarlanması.
- Gelişmiş Cache Mimarisi: Redis entegrasyonu ile JSON tabanlı ara okumaların %40 daha performanslı işlenmesini sağlayan bellek (in-memory) yapısının kurulması.
🔒 Gizlilik ve Kod Erişimi Notu:
Ticari/Akademik kısıtlamalar nedeniyle bu projenin kaynak kodları gizli bir depoda (private repository) tutulmaktadır. Bu depo, sistemin mimari özetini ve teknik yetkinlikleri sergilemek amacıyla dışa açık (public) olarak oluşturulmuştur.