Geliştirilme Amacı ve Müşteri İhtiyaçları: Geleneksel yöntemlerle (Excel, defter vb.) yürütülen site yönetim süreçlerinde; aidat ve ek giderlerin takibi, kiracı/mülk sahibi ayrımının yönetilmesi, gecikme faizlerinin hesaplanması ve gelir-gider dengesinin sakinlerle şeffaf paylaşılamaması ciddi operasyonel karmaşaya ve tahsilat kayıplarına yol açmaktadır. Bu proje, site yönetimlerinin operasyonel yükünü en aza indirmek ve şeffaf bir finansal takip altyapısı sağlamak amacıyla geliştirilmiştir.
Temel Özellikler ve Modüller:
Blok, Daire ve Sakin Yönetimi: Blok bazlı daire tanımlamaları, doluluk/boşluk oranları, ev sahibi ve kiracıların ayrı ayrı ilişkilendirilmesi.
Akıllı Aidat ve Finans Yönetimi: Tek tıkla dönemsel toplu aidat oluşturma, gecikme cezası/faizi hesaplama algoritması, daireye özel borçlandırma ve kiracı öncelikli akıllı tahsilat mekanizması.
Kasa ve Bilanço Takibi: Tüm gelir-gider kalemlerinin kategorize edilmesi, dinamik grafiklerle nakit akışı analizi ve tek tıkla resmi PDF dökümü/raporlama.
Talep ve Destek Biletleri: Sakinlerin arıza, öneri veya şikayetlerini iletebildiği, yöneticilerin ise durumu (Açık, İşlemde, Çözüldü) takip edebildiği entegre bildirim paneli.
Duyuru ve Bildirimler: Site geneline ya da daire bazına özel anlık duyuru ve borç bildirim sistemi.
Mimari Yapı ve Teknik Yaklaşım:
Backend: Clean Architecture prensiplerine uygun olarak Domain, Application, Infrastructure ve API katmanlarına ayrılmıştır. İş mantığı karmaşıklığını yönetmek için CQRS (MediatR) ve Domain Events yaklaşımları uygulanmıştır.
Güvenlik ve Yetkilendirme: Rol bazlı yetkilendirme (SuperAdmin, Yönetici, Sakin) ve güvenli oturum yönetimi için ASP.NET Core Identity & JWT entegre edilmiştir.
Frontend: React 19, TypeScript ve Vite ile yüksek performanslı ve modern bir SPA (Single Page Application) olarak inşa edilmiştir. Global state için Zustand, sunucu durumu/önbellekleme için TanStack Query ve modern arayüz için Tailwind CSS kullanılmıştır.
Veritabanı & Dağıtım: PostgreSQL ilişkisel veritabanı ile veriler modellenmiş, tüm geliştirme ve çalışma ortamı Docker konteynerleri ile taşınabilir hale getirilmiştir.