Proje Hakkında
Bir hastanenin hasta, doktor, personel ve yönetici süreçlerini tek bir uygulamada toplayan portfolyo projesi. Amaç; randevu planlamasını yönetilebilir kılmak, tıbbi kayıtları yalnızca yetkili kişilere açmak ve faturalandırmayı tek panelden yürütmek. Geliştirme aşamasında bir çalışma olduğu için canlı yayında değil.
Roller ve Yetkiler
Dört rol vardır ve her işlem rol tablosuna göre kısıtlanır (RBAC):
- Hasta: randevu oluşturma/iptal, doktor ve saat seçme, kendi kaydını ve faturalarını görme
- Doktor: randevu taleplerini onaylama/reddetme, takvimde planlama, tanı, reçete ve tetkik sonucu girme
- Personel: randevu ve hasta kayıtlarını yönetme, fatura oluşturma, ödeme durumunu izleme
- Yönetici: doktor ve personel yönetimi, raporlar, tüm kayıtlara erişim
Örneğin hasta silme yalnızca yöneticide, hasta ekleme/düzenleme personel ve yöneticide, hastanın ise yalnızca kendi kaydı görünür.
Modüller
- Randevu yönetimi: talep → onay/ret (ret gerekçesiyle) → tamamlandı/iptal akışı; takvim görünümü (FullCalendar)
- Hasta kayıtları: kimlik ve iletişim bilgisi, kan grubu, alerji, kronik hastalık, tanılar, doktor notları, reçeteler ve tetkik sonuçları
- Fatura ve ödeme: kalemli fatura, KDV/indirim, kısmi ödeme; ödeme yöntemleri (nakit, kart, sigorta, havale) ve gecikmiş fatura takibi
- Personel işleri: çalışma programı ve izin talepleri (onay/ret)
- Bildirimler: randevu onayı/reddi, yeni randevu, ödeme alındı gibi olaylarda uygulama içi bildirim
- Raporlama: gelir-gider ve randevu istatistikleri için grafikler (Recharts)
- Denetim kaydı: kim neyi, ne zaman, hangi IP'den değiştirdi
Kullanıcı Deneyimi
Sayfalama, kolon başlığıyla sıralama, gelişmiş filtreler, debounce'lu arama, iskelet yükleme ekranları, boş durum gösterimleri ve her formda toast bildirimleri; mobilde hamburger menü ve duyarlı tablolar. Formlar React Hook Form ve Zod ile hem istemcide hem sunucuda doğrulanır.
Teknik Yapı
- Next.js 16 (App Router), React 19, TypeScript
- Prisma 7 ve PostgreSQL; 18 modelli şema
- NextAuth v5 (JWT, kimlik bilgileri) ve bcrypt
- Tailwind CSS 4, Recharts, FullCalendar, React Hook Form, Zod
Bu Projeden Öğrendiklerim
Karmaşık bir alanı (sağlık) rol bazlı yetkilerle modellemek, hassas verilerin erişimini sunucu tarafında sınırlamak ve çok modüllü büyük bir uygulamayı faz faz, öncelikli bir yol haritasıyla geliştirmek.
