Proje Hakkında
Kütüphane envanterini (kitaplar, yazarlar, yayınevleri, kategoriler) ve ödünç alma işlemlerini tek yerden yönetmek için geliştirdiğim tam kapsamlı bir web uygulaması. Arka uçta Java 17 ile Spring Boot, ön yüzde React 19 kullanıyor; uygulama canlıda çalışıyor ve aşağıdaki bağlantılardan denenebilir.
Neler Yapabiliyor?
- Kitap, yazar, yayınevi ve kategori kayıtlarını ekleme, düzenleme, silme ve listeleme
- Ödünç alma kayıtları: kim, hangi kitabı, hangi tarihler arasında aldı
- Akıllı doğrulamalar: iade tarihi ödünç alma tarihinden önce olamaz, stokta olmayan kitap ödünç verilemez
- Masaüstü ve mobil için ayrı deneyim: geniş ekranda ayrıntılı tablolar, telefonda dokunmatiğe uygun kart görünümü ve otomatik kapanan menü
- Material UI ile özelleştirilmiş tema, modern renk paleti ve cam (glassmorphism) efektleri
- Türkçe arayüz, Türkçe hata mesajları ve GG.AA.YYYY tarih formatı
Mimari
Uygulama iki parçadan oluşuyor ve birbirinden bağımsız yayınlanıyor:
- Backend: Spring Boot REST API; Controller, Service, Entity ve Repository katmanları ayrı tutuldu. Veriler PostgreSQL'de, yerel geliştirme için Docker Compose ile ayağa kalkıyor.
- Frontend: Vite ile derlenen React 19 uygulaması. Sayfalar (kitaplar, yazarlar vb.), ortak bileşenler, Axios tabanlı servis katmanı ve tek merkezden yönetilen tema ayrı klasörlerde.
- Yayın: API Docker imajı olarak Render'da, ön yüz Netlify'da çalışıyor; ön yüz API adresini ortam değişkeninden alıyor.
Teknolojiler
- Backend: Java 17, Spring Boot, PostgreSQL, Maven, Docker, Docker Compose
- Frontend: React 19, Vite, Material UI v6, Axios, React Router
Bu Projeden Öğrendiklerim
Ön yüz ile API'yi ayrı yayınlamanın getirdiği yapılandırma meseleleri (ortam değişkenleri, CORS, taban adresler), bir tablo arayüzünü mobilde kart görünümüne dönüştürmek ve iş kurallarını (tarih tutarlılığı, stok) kullanıcıya anlaşılır mesajlarla sunmak.
