Bana lazım olan bir Projeydi sizlerlede paylaşmak istedim Yönetilebilinir apartman yönetim scripti...

================================================== ===================
APARTMAN YÖNETİM SİSTEMİ v1.5 — TANITIM
================================================== ===================

KISA TANITIM (ilan / sosyal medya için)
---------------------------------------------------------------------
Apartman ve site yönetimini kâğıttan, Excel'den ve dağınık WhatsApp
mesajlarından kurtarın. Aidat borçlandırma, tahsilat, gelir-gider,
banka dekontu onayı ve PDF makbuz tek bir web panelinde.

Sakin ödemesini yaptığında makbuzu e-posta, SMS veya WhatsApp ile
kendiliğinden gelir; mesajdaki bağlantıya dokunduğunda şifre girmeden
makbuzunu görür ve PDF olarak indirir. Duyurular da aynı şekilde
herkesin telefonuna ulaşır.

KVKK aydınlatma metni, açık rıza, gizlilik ve çerez politikası ile
kullanım koşulları hazır gelir; her sakinin onayı tarih ve sürümüyle
kayıt altına alınır. Yönetici, muhasebe, denetçi ve daire sakinleri
kendi yetkileriyle giriş yapar; herkes yalnızca görmesi gerekeni
görür. Telefon, tablet ve bilgisayardan çalışır, uygulama indirmek
gerekmez. Kendi sunucunuza veya hostinginize kurulur, verileriniz
sizde kalır.


v1.5 İLE GELEN YENİLİKLER
---------------------------------------------------------------------
• SMS bildirimleri: Netgsm, Twilio veya API'si olan herhangi bir SMS
firması ile makbuz, dekont onay/red ve duyuru mesajları.
• WhatsApp bildirimleri: Resmi Meta WhatsApp Cloud API veya Twilio
WhatsApp ile otomatik gönderim; API olmadan da tek dokunuşla
"WhatsApp'ta aç" paylaşımı.
• KVKK uyumu: Aydınlatma metni, açık rıza metni, gizlilik politikası,
çerez politikası ve kullanım koşulları; sürüm yönetimi ve onay
kayıtları.
• İlk giriş onayı: Kullanıcı sisteme ilk girdiğinde ve metinler
güncellendiğinde onay ekranı çıkar.
• Çerez bildirimi: "Yalnızca zorunlu / Tümünü kabul et" seçenekleri.
• Sakinin gizlilik paneli: Onay geçmişi, açık rızayı verme/geri alma,
kişisel verileri tek tıkla indirme.
• Süreli kayıt imhası: Eski işlem ve bildirim kayıtları otomatik
silinir.


GENEL TANITIM
---------------------------------------------------------------------
Apartman Yönetim Sistemi, bir apartmanın veya sitenin bütün mali ve
idari işlerini tek yerden yürütmek için hazırlanmış, PHP ve MySQL
tabanlı bir web yazılımıdır.

Her ay aidat dönemi oluşturulduğunda bütün daireler tek tıkla
borçlandırılır. Ödemeler alındıkça borçlar kapanır, tutar kasaya
otomatik olarak gelir yazılır ve sakine makbuz bildirimi gider:
e-posta, SMS ve WhatsApp — hangi kanallar açıksa. Havale veya EFT ile
ödeme yapan sakin dekontunu kendi hesabından yükler; yönetici dekontu
sayfadan çıkmadan inceleyip onaylar ya da gerekçe yazarak reddeder,
sakin sonucu anında öğrenir. Giderler kategorilere göre kaydedilir,
raporlar ve grafikler anlık olarak güncellenir.

Kim neyi görecek, neyi değiştirebilecek, tamamen yöneticinin
kararıdır: 36 ayrı yetki rollere atanır ve istenirse tek bir
kullanıcıya rolünden bağımsız olarak ek izin verilir ya da yetki
kısıtlanır.

Kişisel verilerin korunması için gereken metinler ve kayıtlar
sistemle birlikte gelir: her kullanıcı ilk girişinde kullanım
koşullarını ve KVKK aydınlatma metnini onaylar, isteğe bağlı açık
rızasını verir; yönetim bu onayları tarih, sürüm ve IP adresiyle
görebilir.


ÖNE ÇIKAN ÖZELLİKLER
---------------------------------------------------------------------
• Toplu aidat borçlandırma: Aylık dönemi açın, bütün daireler tek
tıkla borçlansın. Büyük dairelere katsayı (ör. ×1,25), boş dairelere
muafiyet, son ödeme tarihi geçenlere gecikme bedeli.
• Tahsilat: Kısmi ödeme, daire bazında toplu tahsilat (tutar en eski
borçtan başlayarak dağıtılır), ödeme yöntemi takibi.
• Dekont yükleme ve onay: Sakin banka dekontunu PDF ya da fotoğraf
olarak yükler; yönetici önizler, onaylar veya gerekçeyle reddeder.
• PDF makbuz: Tutarı yazıyla, ödeme kalemleri, "ÖDENDİ" damgası, kalan
borç ve sahteciliğe karşı doğrulama kodu.
• Üç kanallı bildirim: Tahsilat alındığında, dekont onaylandığında
veya reddedildiğinde ve duyuru yayınlandığında sakine e-posta, SMS
ve/veya WhatsApp. Her kanal ve her olay ayrı ayrı açılıp kapatılır.
• SMS (YENİ):
– Netgsm, Twilio veya özel HTTP (her firmaya uyarlanabilir)
– Onaylı SMS başlığı, Türkçe karakter seçeneği
– Kısa bağlantı ile tek SMS'e sığan ekonomik mesajlar
– Her şablonun kaç karakter / kaç SMS tutacağı ekranda görünür
• WhatsApp (YENİ):
– Resmi Meta WhatsApp Cloud API (onaylı şablon veya serbest metin)
– Twilio WhatsApp desteği
– API'siz kullanım: makbuz ve duyuru sayfasındaki "WhatsApp'ta aç"
ve "WhatsApp grubunda paylaş" düğmeleri
• Düzenlenebilir mesaj şablonları: {site} {daire} {tutar} {tarih}
{neden} {baslik} {link} alanlarıyla.
• Tek tıkla detay: E-posta, SMS veya WhatsApp'taki bağlantı, sakinden
şifre istemeden yalnızca o makbuzu veya duyuruyu açar. Bağlantılar
imzalı ve sürelidir; giriş yapmış kullanıcı panel içindeki detay
sayfasına yönlendirilir.
• Güvenilir gönderim: Bütün bildirimler arka planda gönderilir
(yönetici beklemez), başarısız olanlar otomatik yeniden denenir,
her gönderim durum ve hata nedeniyle kayıt altındadır. Panelden
test mesajı gönderilebilir.
• Gönderim izni: Daire kartından "SMS / WhatsApp bildirimi" kapatılır;
sakin de Profilim sayfasından e-posta veya mesaj almayı kapatabilir.
• KVKK ve yasal metinler (YENİ):
– KVKK Aydınlatma Metni, Açık Rıza Metni, Gizlilik Politikası,
Çerez Politikası, Kullanım Koşulları hazır taslak olarak gelir
– Site adı, adres, veri sorumlusu ve başvuru adresleri metinlere
otomatik yazılır
– Canlı önizlemeli düzenleyici, "düzeltme" veya "yeni sürüm"
olarak yayımlama, varsayılana dönme
– Yeni sürümde kullanıcılardan otomatik yeniden onay
– Onay kayıtları: kim, hangi metni, hangi sürümü, ne zaman, hangi
IP ve tarayıcıdan onayladı ya da rızasını geri aldı
• Çerez bildirimi (YENİ): Yalnızca zorunlu çerezler kullanılır; tercih
çerezi için izin istenir, seçim sonradan değiştirilebilir.
• Sakinin hakları (YENİ): Profilim › Gizlilik bölümünde onay geçmişi,
açık rızayı verme / geri alma ve kişisel verilerin JSON dosyası
olarak indirilmesi (KVKK md. 11).
• Saklama ve imha (YENİ): İşlem kayıtları belirlenen süre sonunda
(varsayılan 730 gün), bildirim kayıtları 365 gün sonra otomatik
silinir.
• Gelir-gider: Kategorili kayıt, belge/fatura numarası, Excel (CSV)
aktarımı.
• Raporlar: Yıllık gelir-gider tablosu ve kasa seyri, kategori × ay
dökümü, daire bazında borç ve ödeme oranı.
• Rol ve kişiye özel yetki: Hazır roller, sınırsız yeni rol, her
kullanıcıya "İzin ver / Engelle" istisnası, salt okunur şablonu.
• Bilgi maskeleme: Yetkisi olmayan kullanıcıya isimler "A*** Y***",
telefonlar gizli gösterilir.
• İşlem kayıtları: Kim, ne zaman, hangi IP'den ne yaptı.
• Kolay kurulum: Kurulum sihirbazı ilk açılışta otomatik başlar; yeni
sürüm yüklendiğinde veritabanı kendiliğinden güncellenir.
• Mobil uyumlu, açık ve koyu tema.


KULLANICI ROLLERİ (hazır gelir, değiştirilebilir)
---------------------------------------------------------------------
• Süper Yönetici : Bütün yetkiler; sistem ayarları, roller, yetkiler, yasal metinler.
• Yönetici : Günlük yönetim; daire, aidat, tahsilat, gider, duyuru, kullanıcı, e-posta ve SMS/WhatsApp.
• Muhasebe : Aidat, tahsilat, dekont onayı, gelir-gider, raporlar.
• Denetçi : Her şeyi görür, hiçbir şeyi değiştiremez.
• Sakin : Yalnızca kendi dairesinin borçlarını ve makbuzlarını görür, dekont yükler, bildirim alır.


TEKNİK BİLGİLER
---------------------------------------------------------------------
• PHP 8.0 veya üzeri, MySQL 5.7+ / MariaDB 10.3+
• XAMPP, WAMP, Laragon veya cPanel/Plesk'li paylaşımlı hosting
• Harici kütüphane gerekmez (PDF, e-posta, SMS ve WhatsApp dahil)
• E-posta: SMTP (TLS / SSL) veya PHP mail()
• SMS: Netgsm XML API, Twilio, özel HTTP (GET/POST, JSON/form)
• WhatsApp: Meta WhatsApp Cloud API, Twilio WhatsApp
• SMTP şifresi ve SMS/WhatsApp erişim anahtarları veritabanında
AES-256 ile şifreli saklanır.
• İsteğe bağlı Cron ile düzenli gönderim
• Güvenlik: Hazır sorgular, şifreli parola saklama, CSRF ve XSS
koruması, hatalı giriş sınırı, yüklenen dosyaların içerik imzasıyla
doğrulanması, imzalı ve süreli bağlantılar.

Notlar:
• Hazır yasal metinler genel taslaktır; yayına almadan önce bir hukukçuya kontrol ettirilmesi önerilir.
• Meta WhatsApp'ta işletmenin başlattığı mesajlar için Meta tarafından onaylanmış bir şablon gerekir.
• Makbuz, ödeme sonucu ve yönetim duyuruları bilgilendirme iletisidir; İYS onayı gerektirmez.


================================================== ===================
EKRAN GÖRÜNTÜLERİ VE AÇIKLAMALARI
================================================== ===================
Not: Görüntülerdeki site, kişi, telefon, e-posta adresi ve tutarlar tanıtım amaçlı örnek verilerdir (16 daireli "Yeşil Vadi Sitesi").

— TANITIM GÖRSELLERİ —
01_kapak.jpg
Tanıtım kapağı: bilgisayar ve telefonda kontrol paneli, öne çıkan özellikler ve v1.5 yenilikleri.
02_one-cikan-ozellikler.jpg
On altı ana özelliğin özet görseli; yeni olanlar işaretli.
03_sms-whatsapp-bildirimleri.jpg
SMS ve WhatsApp özelliğinin özeti: ayar ekranı ve sakinin telefonuna gelen makbuz, duyuru ve onay mesajları.
04_kvkk-gizlilik-cerez.jpg
KVKK özelliklerinin özeti: yasal metin yönetimi ve telefonda ilk giriş onay ekranı.
05_eposta-bildirimleri.jpg
Otomatik e-posta: "Ödemeniz onaylandı" e-postası ve tek dokunuşla açılan makbuz.
06_mobil-uyum.jpg
Telefonda yönetici paneli, menü ve sakinin borç sayfası.

— GİRİŞ VE ONAY —
07_giris-ekrani.jpg
Giriş ekranı; altında Kullanım Koşulları ve KVKK bağlantıları.
08_giris-cerez-bildirimi.jpg
İlk ziyarette çıkan çerez bildirimi: "Yalnızca zorunlu" veya "Tümünü kabul et".
09_ilk-giris-onay-ekrani.jpg
Kullanıcının ilk girişinde açılan onay ekranı: Kullanım Koşulları ve KVKK Aydınlatma Metni kaydırılabilir kutularda.
10_onay-ekrani-isaretli.jpg
Zorunlu onaylar ve isteğe bağlı açık rıza işaretlenmiş hâli; onay tarih, IP ve tarayıcı bilgisiyle kaydedilir.
11_metin-guncellendi-yeniden-onay.jpg
Yönetim bir metnin yeni sürümünü yayımladığında kullanıcıya çıkan "Metinlerimiz güncellendi" ekranı.

— KONTROL PANELİ VE DAİRELER —
12_kontrol-paneli.jpg
Yöneticinin kontrol paneli: kasa bakiyesi, aylık gelir ve gider, bekleyen alacak, 12 aylık grafik, gider dağılımı; menüde yeni "SMS & WhatsApp" ve "Yasal Metinler" bölümleri.
13_kontrol-paneli-tam-sayfa.jpg
Kontrol panelinin tamamı; alt bilgide yasal metin bağlantıları.
14_kontrol-paneli-koyu-tema.jpg
Aynı panel koyu temada.
15_daireler.jpg
Daire listesi: blok, kat, metrekare, malik ve oturan, katsayı, güncel borç.
16_daire-duzenleme.jpg
Daire kartı: malik ve sakin bilgileri, bağlı kullanıcı, notlar ve yeni "SMS / WhatsApp bildirimi gönderilebilir" izni.

— AİDAT, BORÇ VE TAHSİLAT —
17_aidat-donemleri.jpg
Aidat dönemleri ve tahsilat oranları.
18_yeni-aidat-donemi.jpg
Yeni dönem: tutar, son ödeme tarihi, toplu borçlandırma seçenekleri.
19_borc-ve-tahsilat.jpg
Bütün borçlar; daire, dönem, tür ve durum filtreleri.
20_gecikmis-borclar.jpg
Son ödeme tarihi geçmiş borçlar.
21_daire-borc-detayi.jpg
Tek dairenin bütün borçları ve toplam kalan.
22_toplu-tahsilat.jpg
Daire bazında toplu tahsilat; tutar en eski borçtan dağıtılır.
23_tahsilat-alma.jpg
Tek borç için tahsilat; "Sakine makbuz bildirimi gönder (e-posta / SMS / WhatsApp)" seçeneği.
24_odeme-bildirimleri.jpg
Sakinlerin gönderdiği ödeme bildirimleri ve dekontlar.
25_dekont-onizleme-pdf.jpg
PDF dekontun sayfadan çıkmadan önizlenmesi.
26_dekont-onizleme-fotograf.jpg
Telefonla çekilmiş dekont fotoğrafının önizlenmesi.
27_bildirim-onaylama.jpg
Bildirimi onaylama; onayda borçlar kapanır, kasaya gelir yazılır, sakine bildirim gider.
28_onaylanan-bildirimler.jpg
Onaylanan bildirimler ve makbuz bağlantıları.

— MAKBUZ —
29_tahsilat-gecmisi.jpg
Tahsilat geçmişi: filtreler, yöntem toplamları, makbuz ve dekont.
30_makbuz-detayi.jpg
Panel içindeki makbuz detayı: kalemler, toplam, yazıyla tutar, kalan borç, doğrulama kodu.
31_makbuz-gonderim-dugmeleri.jpg
Makbuz sayfasındaki düğmeler: PDF, yazdır, e-postayla gönder, SMS / WhatsApp ile gönder ve API'siz "WhatsApp'ta aç".
32_pdf-makbuz.jpg
Otomatik oluşturulan PDF tahsilat makbuzu.
33_makbuz-yazdirma.jpg
Makbuzun yazdırılabilir görünümü.

— SMS & WHATSAPP (YENİ) —
34_sms-whatsapp-ayarlari.jpg
SMS ve WhatsApp ayarları: kanal açık/kapalı, sağlayıcı seçimi (Netgsm / Twilio / Özel HTTP, Meta Cloud API / Twilio), erişim
bilgileri, SMS başlığı, Türkçe karakter seçeneği ve hangi olayların gönderileceği. Üstte kanal durumu, geçerli telefon sayısı ve gönderim istatistikleri.
35_sms-whatsapp-ayarlari-tam-sayfa.jpg
Sayfanın tamamı: şablonlar, test mesajı, yasal notlar ve gönderim kayıtları.
36_sms-whatsapp-koyu-tema.jpg
Aynı sayfa koyu temada.
37_mesaj-sablonlari.jpg
SMS ve WhatsApp mesaj şablonları; her şablonun örnek çıktısı, karakter sayısı ve kaç SMS tutacağı.
38_test-mesaji-ve-yasal-notlar.jpg
Tek tıkla test SMS'i / WhatsApp mesajı; İYS, KVKK ve gönderim izni hakkında bilgilendirme.
39_mesaj-gonderim-kayitlari.jpg
Gönderim kayıtları: kanal, tür, alıcı, mesaj, durum ve sağlayıcı numarası; sıradakileri gönderme, tekrar deneme ve iptal.
40_daire-mesaj-izni.jpg
Daire kartında SMS / WhatsApp gönderim izni.

— E-POSTA —
41_eposta-ayarlari.jpg
E-posta ayarları: hazır sağlayıcı ayarları, SMTP, otomatik gönderim seçenekleri, test e-postası.
42_eposta-gonderim-kayitlari.jpg
E-posta gönderim kayıtları.
43_eposta-onizleme.jpg
Gönderilen e-postanın panelden önizlenmesi.
44_eposta-odeme-alindi.jpg
"Ödemeniz alındı" e-postası.
45_eposta-odeme-onaylandi.jpg
"Ödeme bildiriminiz onaylandı" e-postası.
46_eposta-odeme-bildirimi-reddedildi.jpg
Red nedeniyle birlikte bilgilendirme e-postası.
47_eposta-duyuru.jpg
Bütün sakinlere giden duyuru e-postası.
48_baglanti-makbuz-sayfasi.jpg
Bağlantıyla şifresiz açılan makbuz sayfası ve PDF indirme.
49_baglanti-duyuru-sayfasi.jpg
Bağlantıyla açılan duyuru sayfası.
50_baglanti-red-sayfasi.jpg
Reddedilen bildirimin bağlantı sayfası: neden, açık borçlar, IBAN.

— DUYURULAR —
51_duyurular.jpg
Duyurular; önemliler en üstte.
52_yeni-duyuru-bildirim-secenegi.jpg
Yeni duyuru: "Yayınlarken tüm sakinlere bildir (e-posta / SMS / WhatsApp)" seçeneği.
53_duyuru-detayi.jpg
Duyuru detayı: "Sakinlere bildir" ve "WhatsApp grubunda paylaş" düğmeleri.

— KVKK VE YASAL METİNLER (YENİ) —
54_yasal-metinler-yonetimi.jpg
Yasal metin yönetimi: onay istatistikleri (kullanım koşulları, KVKK, açık rıza), metin sekmeleri, düzenleyici ve canlı önizleme.
55_yasal-metinler-tam-sayfa.jpg
Sayfanın tamamı: KVKK ayarları ve onay kayıtları.
56_acik-riza-metni-duzenleme.jpg
Açık Rıza Metni'nin düzenlenmesi (isteğe bağlı rıza).
57_kvkk-ayarlari-ve-onay-kayitlari.jpg
Veri sorumlusu, KVKK başvuru e-postası, KEP adresi, kayıt saklama süresi, onay ve çerez seçenekleri; kullanıcı bazında onay kayıtları.
58_kvkk-aydinlatma-metni.jpg
Herkese açık KVKK Aydınlatma Metni sayfası; yazdırılabilir.
59_cerez-politikasi.jpg
Çerez Politikası sayfası.
60_acik-riza-metni.jpg
Açık Rıza Metni sayfası.

— GELİR-GİDER VE RAPORLAR —
61_gelirler.jpg
Gelir kayıtları ve kategori özeti.
62_giderler.jpg
Gider kayıtları; Excel (CSV) aktarımı.
63_gider-ekleme.jpg
Yeni gider formu.
64_gelir-gider-kategorileri.jpg
Gelir ve gider kategorileri.
65_rapor-gelir-gider-ozeti.jpg
Yıllık rapor ve kasa seyri grafiği.
66_rapor-koyu-tema.jpg
Rapor ekranı koyu temada.
67_rapor-kategori-dokumu.jpg
Kategorilerin aylara göre dökümü.
68_rapor-daire-borc-durumu.jpg
Daire bazında tahakkuk, ödeme, kalan ve ödeme oranı.

— KULLANICILAR VE YETKİLER —
69_kullanicilar.jpg
Kullanıcı listesi.
70_kullanici-ekleme.jpg
Yeni kullanıcı formu.
71_kullaniciya-ozel-yetki.jpg
Kullanıcıya özel "Rolden / İzin ver / Engelle" yetkileri.
72_roller.jpg
Roller ve yetki oranları.
73_rol-yetki-duzenleme.jpg
Rol yetkilerinin düzenlenmesi.
74_yetki-matrisi.jpg
Yetkilerin rollere göre karşılaştırması.
75_kat-temsilcisi-maskeli-gorunum.jpg
Kişisel bilgi yetkisi olmayan kullanıcıda maskeli isimler.

— SAKİN EKRANLARI —
76_sakin-kontrol-paneli.jpg
Sakinin paneli: borcu, gecikmiş tutar, IBAN, duyurular.
77_sakin-borclarim.jpg
"Borçlarım": borç hareketleri, bildirimler, makbuzlar.
78_sakin-odeme-bildirimi.jpg
Sakinin ödeme bildirimi ve dekont yükleme.
79_sakin-profil-ve-gizlilik.jpg
Sakin profili: e-posta ve SMS/WhatsApp bildirim tercihleri, şifre ve gizlilik bölümü.
80_sakin-gizlilik-ve-onaylarim.jpg
"Gizlilik ve Onaylarım": hangi metni hangi sürümde onayladığı, açık rızayı verme/geri alma, "Verilerimi indir (JSON)".
81_yetkisiz-erisim.jpg
Yetkisiz sayfaya girişte gösterilen uyarı.

— SİSTEM VE KURULUM —
82_islem-kayitlari.jpg
İşlem kayıtları; kullanıcı ve IP ile.
83_ayarlar.jpg
Site bilgileri ve aidat varsayılanları.
84_profil.jpg
Yöneticinin profil sayfası.
85_kurulum-1-gereksinimler.jpg
Kurulum sihirbazı: sunucu uygunluk kontrolü.
86_kurulum-2-veritabani.jpg
Veritabanı bilgileri; veritabanı yoksa otomatik oluşturulur.
87_kurulum-3-site-ve-yonetici.jpg
Site bilgileri ve yönetici hesabı.
88_kurulum-4-tamamlandi.jpg
Kurulum tamamlandı ekranı.

— MOBİL (mobil/ klasörü) —
mobil-yonetici-paneli.jpg — Telefonda yönetici kontrol paneli
mobil-menu.jpg — Telefonda açılır menü
mobil-sakin-borclarim.jpg — Telefonda sakinin borç sayfası
mobil-ilk-giris-onayi.jpg — Telefonda ilk giriş onay ekranı (YENİ)
mobil-cerez-bildirimi.jpg — Telefonda giriş ve çerez bildirimi (YENİ)
mobil-gizlilik-ve-onaylarim.jpg — Telefonda gizlilik ve onaylar (YENİ)
mobil-eposta.jpg — Telefonda "Ödemeniz onaylandı" e-postası
mobil-makbuz-baglantisi.jpg — Bağlantıyla telefonda açılan makbuz
mobil-duyuru-baglantisi.jpg — Bağlantıyla telefonda açılan duyuru