GZL Temizlik, Gemlik ve Bursa çevresinde temizlik hizmeti ile apartman ve site yönetimini birlikte yürüten bir işletme için geliştirilen canlı platformdur. Tek bir sistem üç farklı kullanıcıya hizmet eder: hizmet arayan ve teklif isteyen müşteri, aidatını ve duyurularını takip eden apartman sakini, ve sahadaki ekipten kasa defterine kadar tüm operasyonu yöneten yönetici.

Proje bağlamı ve ihtiyaç

Temizlik işi ile apartman yöneticiliği aynı ekip tarafından yürütüldüğünde iş birbirine karışır: aynı binaya hem merdiven temizliği hem aidat tahsilatı hem de kat malikleri toplantısı düşer. Önceki düzende teklifler e-posta ve telefonda, personel planı tablolarda, aidat takibi ise ayrı dosyalarda tutuluyordu. Apartman yöneticiliği ayrıca Kat Mülkiyeti Kanunu'na bağlı bir iştir; toplantı çağrısı, karar defteri, işletme projesi ve tebligat gibi adımların kanıtlı ve sırasıyla yapılması gerekir. Hedef, bu iki iş kolunu tek veri modelinde, bina bazında birbirinden yalıtılmış şekilde yönetmekti.

Çözüm ve kapsam

Müşteri sitesi

Kurumsal sitede ev, ofis, derin temizlik, inşaat sonrası, apartman ve merdiven, cam, koltuk, depo ve havuz temizliği ile çim biçme ve apartman/site yönetimi olmak üzere 11 hizmet ayrı detay sayfalarıyla sunulur. Ziyaretçi teklif formu ya da randevu sayfasından talebini iletir; teklifler numaralandırılır, PDF olarak üretilir ve e-postayla gönderilir. Apartman yönetimi için ayrı bir tanıtım sayfası, 20 bölümlük herkese açık bir apartman yöneticiliği kılavuzu, blog, haberler, SSS ve KVKK metinleri yayındadır.

Sakin portalı

Apartman sakinleri giriş yaptıktan sonra yalnız kendi dairelerine ait verileri görür: toplam tahakkuk, ödenen tutar ve kalan borç özetleri, dönem dönem aidatlar, ödeme geçmişi, duyurular ve belgeler. Toplantı çağrısının tebliğ durumu ve katılım bilgisi, DASK poliçe durumu ve borç durum yazısı da portaldan izlenir; sakin buradan talep açabilir ve PDF ekstre indirebilir.

QR ile arıza bildirimi

Binaya asılan QR afiş, giriş gerektirmeyen bir bildirim formuna açılır. Zorunlu alan yalnız kategori ve açıklamadır; fotoğraf telefonda küçültülerek anında yüklenir. Böylece sakin bir uygulama indirmeden ortak alandaki sorunu yönetime iletebilir.

Yönetim paneli

Panel iki ana bölümden oluşur. Temizlik bölümünde müşteriler ve mülkleri, personel kartları, görevler, iş takvimi ve finans yönetilir. Vardiya şablonundan aylık plan çakışma kontrolüyle üretilir; aynı plan iki kez oluşturulduğunda kayıt tekrarlanmaz. Ziyaret ekibi, sıra ve iş fotoğrafları kayıt altına alınır.

Apartman bölümü ise bir apartman yöneticisinin yıl boyunca ihtiyaç duyduğu her şeyi kapsar:

• Finans: aidatlar, FIFO mantığıyla tahsilat, kasa defteri, gelir ve gider kayıtları, borçlular listesi, ekstre ve dönem kilidi.
• İşletme projesi ve dağıtım: kuruş hassasiyetli gider dağıtımı, onay zinciri, bütçe ile tahakkukun eşitliğinin denetlenmesi ve yüzde 70 tüketim, yüzde 30 alan esaslı ısı paylaşımı.
• Toplantı ve karar: toplantı çağrısı, hazirun, vekâlet, çoğunluk hesabı, kararlar ve defterler.
• Belge üretimi: apartman kimlikli PDF belgeler, belge sayaçları, saklama sınıfları ve tebliğ kaydı.
• Takip ve hukuk: tahsilat kademeleri, ihtarname ve icra belge seti, hukuk dosyaları.
• Bina ve bakım: binalar, daireler, sakinler, demirbaş, ekipman ve asansör kontrolleri, sözleşmeler, sigortalar ve yükümlülük takvimi.
• Personel ve devir: görevliler, izin ve özlük kayıtları, 21 kalemli devir teslim tutanağı.
• Süreç ve KVKK: kanıt adımlı süreç sihirbazı, kontrol listeleri, acil durum kartları ve kamera denetimi kayıtları.

Bunlara ek olarak web içeriği (hizmetler, teklifler, randevular, mesajlar), kullanıcılar, rol ve yetki tanımları, oturum yönetimi, dosyalar ve denetim geçmişi aynı panelden yönetilir.

Teknik mimari

Sistem üç uygulamadan oluşur: Next.js ve React ile yazılmış müşteri sitesi, ayrı bir Next.js yönetim paneli ve Bun üzerinde çalışan Fastify API. Veri katmanında MySQL ve Drizzle ORM, doğrulamada Zod kullanılır. Kimlik doğrulama JWT ile yapılır; her kayıt tenant ve apartman kapsamına bağlıdır, bir yönetici yalnız yetkili olduğu binanın verisine erişebilir. Bildirim ve zamanlanmış işler ayrı bir worker sürecinde çalışır.

Finans hesapları, dağıtım kuralları, toplantı çoğunluğu ve belge kuralları gibi hata kaldırmayan alanlar 86 test dosyasıyla korunur; aralarında tam bir yılı bütçeden devir teslime kadar baştan sona çalıştıran regresyon senaryosu da vardır. Önceki sürümden veri göçü tekrar çalıştırılabilir ve veri doğrulamasıyla birlikte yapılmıştır.

Sitedeki görünür metinlerin çoğu kod yerine site ayarlarından okunur; bu sayede hizmet metinleri yeniden yayın gerektirmeden güncellenebilir. Sayfalar sunucu tarafında üretilir, site haritası, robots.txt ve llms.txt uçları teknik SEO için hazırdır.

Entegrasyonlar

• Iyzico: sakinlerin aidatını online ödemesi için imzalı geri dönüş, çift idempotency ve mutabakat; ödeme bilgileri tanımlanmadan tahsilat açılmaz.
• SMS ve WhatsApp: Netgsm ve WhatsApp Cloud adaptörleriyle, sakinin rızasına bağlı bildirim kuyruğu.
• E-posta: Nodemailer ile teklif, bildirim ve hesap e-postaları.
• Cloudinary: görsel ve medya yönetimi.

Sonuç ve bugün

GZL Temizlik bugün gzltemizlik.com üzerinde yayında. Müşteri talepleri teklif numarası ve PDF ile kayda giriyor, apartman finansı bina bazında ayrı ve denetlenebilir tutuluyor, sakinler borç ve belge bilgisine yönetimi aramadan ulaşabiliyor. Platform ekibin kendi işinde günlük olarak kullanıldığı için yeni ihtiyaçlar doğrudan sahadan geliyor; temizlik ürünleri satışı ise yol haritasında sonraki aşama olarak duruyor.