# Planner.Apper Projesi Notları

## Genel Bakış
- Planlama ve görev yönetimi için Laravel tabanlı web uygulaması
- Türkçe arayüz ve Türkçe iş terimleri kullanır
- Laravel Jetstream ve Livewire kullanarak frontend framework'ü sağlar
- Yapay zeka servisleri (Mistral ve X.AI) ile görev oluşturma işlevi

## Ana Teknolojiler ve Bağımlılıklar
- Laravel 10.x framework'ü
- Dinamik UI etkileşimleri için Livewire 3.5+
- Kimlik doğrulama ve UI bileşenleri için Jetstream
- Stil için Tailwind CSS ve özel tasarım
- Ek JavaScript işlevleri için Alpine.js
- Varlık derlemesi için Vite
- API kimlik doğrulaması için Sanctum
- Muhtemelen PostgreSQL veritabanı (modeller ve yapılandırmalardan anlaşıldı)

## Mimari
- Laravel ile Model-Görünüm-Denetleyici (MVC) deseni
- Livewire ile bileşen tabanlı UI
- Yapay zeka servisleri için API entegrasyonları (Mistral API, X.AI)
- Özel günlük kaydı sistemi (apper/log-manager)

## Ana Özellikler
1. **Görev Yönetim Sistemi**: Görevler oluşturulabilir, değiştirilebilir, tamamlanabilir ve ertelenebilir
2. **Yapay Zekâ Tabanlı Görev Oluşturma**: Fırsatlardan göreli görevler oluşturmak için Mistral API kullanır
3. **Şirket Yönetimi**: Organizasyonlar görevlerle ilişkilendirilebilecek birden fazla şirkete sahip olabilir
4. **Haftalık Planlama**: Görevleri farklı zaman periyotlarına göre (bugün, bu hafta, gelecek hafta vs.) düzenler
5. **Arama İşlevi**: Farklı varlıklar arasında kapsamlı arama

## Önemli Veri Modelleri
- `User` - Takım yönetimi olan uygulama kullanıcıları
- `Company` - Görevlerin ilişkilendirilebileceği organizasyonlar
- `Task` - Durum takibi yapılan temel görev modeli
- `Opportunity` - Görevler oluşturabilecek satış fırsatları
- `Deal`, `Invoice`, `Offer`, `Hiring`, `BankTransaction` - İş süreçleriyle ilgili modeller
- `Team` - Çok kiracılı takım yönetimi (Jetstream özelliği)

## Ana Denetleyiciler (Controllers)
- `HomeController` - Haftalık görünümleri ve kontrol panelini yönetir
- `TaskController` - Yapay zekâ oluşturmayı da içeren tüm görev işlemlerini yönetir
- Diğer denetleyiciler muhtemelen Http/Controllers dizininde bulunur

## Frontend Yapısı
- Tailwind CSS ile stillendirilmiş Blade şablonları
- Etkileşimli bileşenler için Alpine.js
- resources/views/components içinde bileşen tabanlı yapı
- Ana şablon olarak app.blade.php ile düzen sistemi
- Arama ve UI etkileşimleri için özel JavaScript

## Yapılandırma Özellikleri
- Görev oluşturma için Mistral API entegrasyonu
- Analitik için Yandex Metrika entegrasyonu
- Zengin metin düzenleme için TinyMCE
- Özel yazı tipleri (Google Fonts, Typekit)
- Simgeler için Material Symbols

## Rota (Route) Yapısı
- Ana kontrol paneli haftalık görünüme yönlendirir
- Planlama için haftalık rotalar: `/week/{time}`, `/new-week/{time}`
- Oluşturma, tamamlama vs. işlemleri için görev rotaları
- Jetstream ile kimlik doğrulama
- 'check.user.access' dahil özel ara yazılımlar

## Dikkat Çeken Özellikler
- Satış fırsatlarından görev oluşturma için yapay zekâ entegrasyonu
- Klavye navigasyonu (arama için Ctrl+K)
- Takım yönetimiyle çok kiracılı mimari
- Özel günlük kaydı yöneticisi ile kapsamlı günlük kaydı
- Uygulama genelinde Türkçe yerelleştirme
- Bakiyesi olan şirketler için otomatik e-posta bildirimleri
- Şirketler için görev zaman çizgisi (timeline) görünümü
- Görev notları ve başlıklarını da içerecek şekilde geliştirilmiş arama işlevi

## Geliştirme Notları
- Arama işlevi için özel bileşen
- Görev oluşturma için harici yapay zekâ servisleri entegrasyonu
- Tailwind ve benzersiz görsel öğeler ile özel stil
- İş işlemlerini destekleyen kapsamlı model yapısı
- Ortam değişkenleriyle API anahtarı yönetimi
- Standart Laravel proje yapısı ile Git deposu