Trello panonuzdaki tamamlanmış görevleri yapay zeka ile analiz edin ve özetleyin.

Projeyi AI Studio'da görüntüleyin: https://ai.studio/apps/drive/1_FMmNVP4djK6XyivbQO2MvZtz524E1xr

• Projenin Tam Adı: Trello AI Assistant
• Yazar / Sahip: Muhammed Albayrak - @gitmuhammedalbayrak
• Lisans: MIT
• Doğum / Başlangıç Tarihi: 2024
• Geliştirilme Durumu: Aktif

Bu proje, proje yönetimi süreçlerinde sıkça karşılaşılan bir zorluğa çözüm olarak doğmuştur: tamamlanan görevler üzerinden hızlı ve anlamlı raporlar oluşturmanın ve üretkenliği analiz etmenin zorluğu. Trello gibi araçlar görev takibi için harika olsa da, geçmişe dönük analizler yapmak veya "Bu hafta neler başardık?" gibi basit bir soruya anında yanıt almak genellikle manuel bir çaba gerektirir. Bu araç, bu süreci otomatikleştirmek ve yapay zeka ile daha sezgisel hale getirmek amacıyla geliştirilmiştir.

Bu araç, kullanıcıların Trello panolarından dışa aktardıkları JSON verilerini kullanarak son tamamlanan görevler hakkında hızlıca içgörüler elde etmelerini sağlamayı hedefler. Temel amaç, yapay zeka destekli bir sohbet arayüzü üzerinden üretkenliği analiz etmeyi kolaylaştırmaktır.

• Hızlı Analiz: Trello JSON dosyanızı yükleyerek son bir günde veya ayda tamamlanan görevleri anında filtreleyin.
• Yapay Zeka Destekli Sohbet: Tamamlanan görevler hakkında sorular sorun, özetler alın veya üretkenlik analizi yapın.
• Veri Gizliliği: Tüm işlemler tarayıcıda gerçekleşir, Trello verileriniz sunuculara gönderilmez.

Projenin gelişim süreci ve gelecekteki hedefleri aşağıda özetlenmiştir.

• Kısa Vadeli Hedefler (Now):
  • Kullanıcı arayüzünü (UI/UX) iyileştirmek ve daha akıcı bir deneyim sunmak.
  • Farklı Trello JSON formatları için hata yönetimini güçlendirmek.
  • Yapay zeka cevaplarının kalitesini artırmak için prompt mühendisliği çalışmaları yapmak.
• Orta Vadeli Hedefler (Next):
  • Manuel JSON yüklemesi yerine Trello API'sine doğrudan entegrasyon sağlamak.
  • Analiz sonuçlarını (sohbet özetleri, grafikler) dışa aktarma özelliği eklemek.
  • Temel metrikler için görselleştirme (grafik, tablo) yetenekleri kazandırmak.
• Uzun Vadeli Hedefler (Later):
  • Jira, Asana gibi diğer popüler proje yönetim araçları için destek eklemek.
  • Takım bazında üretkenlik analizi ve karşılaştırmalı raporlar sunmak.
  • Belirli periyotlarda (örn. haftalık) otomatik raporlar ve özetler oluşturan bir sistem geliştirmek.

• Programlama Dili: TypeScript
• Framework / Kütüphaneler: React, Vite, Google GenAI SDK
• Veritabanı: Yok (Veriler yerel JSON dosyasından okunur)
• Etkilenilen Araçlar: <Bu projenin mimarisini veya tasarımını etkileyen önemli araçlar veya projeler>

Proje, tüm işlemlerin kullanıcı tarayıcısında çalıştığı bir İstemci Taraflı Tek Sayfa Uygulaması (Client-side Single Page Application - SPA) olarak tasarlanmıştır.

Anahtar bağımlılıklar @google/genai, react ve react-dom'dur. Tüm bağımlılıkların listesi için package.json dosyasına bakın.

• İşletim Sistemi: Windows, macOS, Linux
• Diğer Gereksinimler: Node.js (LTS versiyonu önerilir)

1. Repoyu Klonlayın:

   git clone https://github.com/gitmuhammedalbayrak/trello-ai-assistant.git
   cd trello-ai-assistant

2. Bağımlılıkları Yükleyin:

   npm install

3. API Anahtarını Ayarlayın: .env.local.example dosyasının bir kopyasını oluşturup .env.local olarak adlandırın. Ardından dosya içindeki GEMINI_API_KEY değişkenine kendi Google AI Studio API anahtarınızı girin.

   GEMINI_API_KEY="YOUR_API_KEY_HERE"
   

4. Uygulamayı Başlatın: Uygulamayı geliştirme modunda başlatmak için aşağıdaki komutu kullanın. Bu, uygulamayı varsayılan olarak http://localhost:5173 adresinde açacaktır.

   npm run dev

Şu anda bu proje için otomatik testler tanımlanmamıştır. Testler eklemek için katkıda bulunabilirsiniz.

# Örnek bir test komutu (gelecekte eklenebilir)
# npm test

Bu projeye katkıda bulunmak isterseniz, lütfen CONTRIBUTING.md (henüz oluşturulmadı) dosyasını inceleyin. Katkılarınız bizim için değerlidir!

Kısaca:

1. Projeyi fork'layın.
2. Yeni bir özellik dalı (feature/yeni-ozellik) veya hata düzeltme dalı (fix/hata-duzeltme) oluşturun.
3. Değişikliklerinizi commit'leyin.
4. Değişikliklerinizi dalınıza push'layın.
5. Bir Pull Request (PR) açın.

<Bu bölüme, projeye katkıda bulunanların GitHub kullanıcı adlarını veya isimlerini ekleyebilirsiniz.>

• Issues: Hataları bildirmek veya yeni özellikler talep etmek için Issues sayfasını kullanabilirsiniz.
• Project Board: Projenin gelişim sürecini takip etmek için Project Board adresini ziyaret edebilirsiniz (Örnek link).
• Releases: Projenin yayınlanmış sürümlerine Releases sayfasından ulaşabilirsiniz.
• Packages: Proje ile ilgili paketlere Packages sayfasından erişebilirsiniz.

Bu proje MIT Lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakınız.

• Proje Sahibi: Muhammed Albayrak
• GitHub: @gitmuhammedalbayrak
• Destek: Sorularınız veya destek talepleriniz için bir issue açmaktan çekinmeyin.

Not: Bu README dosyası, "Enformasyon Yönetimi Repo Standardı (EY-Repo Std) v1.0" temel alınarak oluşturulmuştur. Gelecekte, bu standardın merkezi bir Repo Standardı ve Lisans Standardı ile entegre edilmesi planlanmaktadır.