Proje Hakkında
Bir şirketin insan kaynakları işlerini tek bir uygulamada toplayan, Türkçe arayüzlü full-stack sistem. Kimlik doğrulamadan bordroya kadar bir İK biriminin günlük ihtiyaçlarını, rol tabanlı erişim kontrolü ile hangi kullanıcının neyi görebileceğini ve değiştirebileceğini belirleyerek karşılıyor. Canlı demo Vercel'de yayında; açılış sayfasından giriş ekranına geçilir.
Roller
- Admin: her şeyi yönetir, duyuru silme gibi kritik işlemler yalnızca onda
- Müdür: personel, izin ve duyuruları yönetir
- Personel: kendi izin, mesai, performans ve bordro bilgilerini görür; kişisel özet panosu vardır
Modüller
- Personel yönetimi: ekleme, düzenleme, silme; departman filtresi; durum takibi (aktif, izinli, askıda, ayrıldı); binlerce kayıt için optimize aranabilir seçici
- İzin yönetimi: talep oluşturma, yönetici onay/ret süreci, izin türleri (yıllık, hastalık, doğum, ücretsiz…) ve izin takvimi
- Çalışma saatleri: giriş/çıkış, fazla mesai ve mola; durumlar (mevcut, devamsız, geç, yarım gün, uzaktan) ve günlük özet
- Performans değerlendirme: 6 kategoride puanlama (üretkenlik, kalite, takım çalışması, iletişim, dakiklik, inisiyatif), çeyrek dönem bazlı, güçlü yanlar/gelişim alanları/hedefler ve genel puan hesabı
- Maaş ve bordro: brüt/net, prim, fazla mesai, kesinti, vergi ve sigorta; ödeme durumu (ödendi/bekliyor)
- Duyuru sistemi: 4 öncelik seviyesi (renk kodlu), sabitleme, son geçerlilik tarihi, arama ve filtre
- Dashboard: yönetici için 6 istatistik kartı, personel için kişisel özet; son duyurular ve hızlı işlemler
Raporlama
Personel, izin, çalışma saatleri, performans ve maaş sayfalarında Excel ve PDF dışa aktarma: aktif filtrelere göre süzülmüş veri, A4 yatay PDF'te şirket başlıklı tablo, Excel'de otomatik kolon genişliği ve Türkçe başlıklar. Dosyalar tarayıcıda üretilir, sunucuya yük binmez.
Teknik Yapı
- Next.js 16 (App Router), React 19, TypeScript
- Prisma 7 ve PostgreSQL; 8 modelli şema (kullanıcı, personel, departman, mesai, izin, performans, maaş, duyuru) ve 33 REST uç noktası
- JWT kimlik doğrulama (HTTP-only çerez), bcrypt, rol kontrolü ayrı bir modülde
- Zustand, React Hook Form + Zod (Türkçe hata mesajlarıyla), shadcn/ui (26 bileşen), Tailwind CSS 4
- Koyu/açık tema, glassmorphism ve mikro animasyonlar; mobil, tablet ve masaüstü uyumlu
- Demo ortamı için verileri sıfırlayan bir iç uç nokta ve 50 personellik örnek veri
Bu Projeden Öğrendiklerim
Rol tabanlı yetkilendirmeyi hem arayüzde hem API'de tutarlı uygulamak, çok modüllü bir iş uygulamasını düzenli klasörlerle ölçeklemek ve raporları istemci tarafında üretmek.
