🐾 Veteriner Yönetim Sistemi

Veteriner kliniklerinin günlük işleyişini tek yerden yöneten tam yığın web uygulaması: hasta (hayvan) kayıtları, randevu takvimi, tıbbi geçmiş ve reçete yönetimi.

Üç farklı kullanıcı rolü — yönetici, veteriner ve hayvan sahibi — kendi paneli üzerinden sisteme erişir. Kimlik doğrulama JWT ile, yetkilendirme rol bazlı yapılır.

Durum: Geliştirme aşamasında, üretime hazır değildir. Backend derleniyor, frontend build alıyor ve temel akışlar çalışır durumda. Otomatik test ve API dokümantasyonu henüz yok — planlanan adımlar için Gelecek çalışmalar.

Ekip

Bu bir ekip projesidir, Işık Üniversitesi kapsamında geliştirilmiştir.

Katkıda bulunan	Rol
Tolga Olguner	Proje Yürütücüsü
Oğulcan Kacar	Baş Yazılım Geliştirici — backend mimarisi ve arayüzün büyük bölümü
Bekir Kadir Demiraslan	Yazılım Geliştirici — backend ve frontend katkıları
Faruk Kılıç	Yazılım Geliştirici
Zübeyde Belma Karataş	Yazılım Geliştirici

Neler yapabiliyor

👤 Hayvan sahibi (CUSTOMER)

Hesap oluşturma, profil yönetimi
Hayvanlarını kaydetme ve güncelleme — tür, ırk, cinsiyet, doğum tarihi, kilo, renk, mikroçip numarası, alerjiler ve notlar
Veterinerin uygun saatlerini görüp randevu talebi oluşturma
Yaklaşan randevularını takip etme
Hayvanının tıbbi geçmişini ve aşı kayıtlarını görüntüleme
Özet istatistikleri gösteren kişisel panel

🩺 Veteriner (VETERINARY)

Çalışma takvimi tanımlama — hangi gün, hangi saatler arası müsait
Gelen randevu taleplerini onaylama, reddetme, durum güncelleme
Takvim görünümünde randevuları yönetme
Kendi müşterilerini ve onların hayvanlarını listeleme
Tıbbi kayıt oluşturma — muayene bulguları, ateş, nabız, kilo, teşhis
Kayıt türüne göre tahlil, aşı, ameliyat ve reçete ekleme
Tahlil sonuçlarını türüne özel algoritmayla otomatik yorumlama
Kayıt geçmişini filtreleyip inceleme

⚙️ Yönetici (ADMIN)

Veteriner hesabı oluşturma
Başvuru onay akışı — bekleyen klinikleri inceleyip onaylama / reddetme / askıya alma
Tüm kullanıcıları listeleme, hesap aktif-pasif yapma
Kullanıcı parolası sıfırlama
Sistem geneli istatistik paneli

Randevu yaşam döngüsü

Talep Edildi ──► Onaylandı ──► Devam Ediyor ──► Tamamlandı
     │                │
     └────────────────┴──► İptal Edildi / Gelmedi

Klinik onay durumları

PENDING (onay bekliyor) → APPROVED (onaylandı) · REJECTED (reddedildi) · SUSPENDED (askıya alındı)

Mimari

┌─────────────────────────┐         ┌──────────────────────────┐
│   React 19 + MUI 7      │  HTTP   │   Spring Boot 3.4.4      │
│                         │ ──────► │                          │
│  • Rol bazlı paneller   │  JWT    │  • 14 REST controller    │
│  • Axios interceptor    │ ◄────── │  • Spring Security       │
│    (token'ı otomatik    │  JSON   │  • Spring Data JPA       │
│     ekler)              │         │  • JWT filtresi          │
└─────────────────────────┘         └────────────┬─────────────┘
      localhost:3000                              │ Hibernate
                                                  ▼
                                        ┌──────────────────┐
                                        │    MySQL 8       │
                                        │  16 entity       │
                                        └──────────────────┘

Kimlik doğrulama akışı: kullanıcı /api/auth/login ile giriş yapar → backend JWT üretir → frontend token'ı localStorage'da tutar → Axios interceptor sonraki her isteğe Authorization: Bearer <token> başlığını ekler → JwtRequestFilter token'ı doğrulayıp güvenlik bağlamını kurar.

Kullanıcı modeli: User temel sınıfından Admin, Veterinary ve Customer türetilir. Roller uygulama ilk açıldığında otomatik oluşturulur.

Tasarım desenleri

Proje üç tasarım desenini bilinçli olarak uygular (ayrıntı: backend/DESIGN_PATTERNS_USAGE.md):

Desen	Nerede	Ne işe yarıyor
Factory	`patterns/factory/MedicalRecordFactory`	Tıbbi kayıt türüne (tahlil / aşı / ameliyat / reçete) göre uygun nesneyi üretir; yeni tür eklemek tek noktadan yapılır
Observer	`patterns/observer/`	Tıbbi kayıt eklendiğinde, güncellendiğinde veya silindiğinde ilgili dinleyicileri otomatik tetikler
Strategy	`patterns/strategy/`	Kan ve idrar tahlillerini farklı algoritmalarla yorumlar; yeni tahlil türü eklemek mevcut kodu değiştirmeden mümkün

Ayrıca Veterinary entity'sinde profil oluşturmak için Builder kullanılır.

Kurulum

Gereksinimler

	Sürüm
JDK	17+
Node.js	18+
MySQL	8 (çalışır durumda)

1. Veritabanını oluştur

mysql -u root -p -e "CREATE DATABASE vms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

Tabloları Hibernate otomatik oluşturur (ddl-auto=update), ayrıca şema betiği çalıştırmana gerek yok.

2. Backend

Sırlar koda gömülü değildir, ortam değişkenlerinden okunur:

Değişken	Zorunlu	Varsayılan	Açıklama
`DB_URL`	hayır	`jdbc:mysql://localhost:3306/vms?...`	JDBC bağlantı adresi
`DB_USERNAME`	hayır	`root`	MySQL kullanıcısı
`DB_PASSWORD`	evet	—	MySQL parolası
`JWT_SECRET`	evet	—	JWT imzalama anahtarı, en az 32 karakter (HS256)
`JWT_EXPIRATION`	hayır	`86400000`	Token ömrü (ms) — varsayılan 24 saat

export DB_PASSWORD="mysql_parolaniz"
export JWT_SECRET="$(openssl rand -base64 48)"
cd backend && ./mvnw spring-boot:run

PowerShell'de:

$env:DB_PASSWORD="mysql_parolaniz"
$env:JWT_SECRET="en_az_32_karakterlik_rastgele_bir_deger"
cd backend; .\mvnw.cmd spring-boot:run

Backend → http://localhost:8080

3. Frontend

cd frontend && npm install && npm start

Frontend → http://localhost:3000 (Backend'in CORS ayarı yalnızca bu adrese izin verir.)

API adresini değiştirmek istersen frontend/.env dosyası oluştur:

REACT_APP_API_BASE_URL=http://localhost:8080/api

4. İlk giriş

Backend ilk açılışta yönetici hesabını oluşturur:

kullanıcı adı: admin
parola:        123456aA

⚠️ Bu parola koda gömülüdür ve herkese açıktır. Gerçek bir kurulumda ilk girişten sonra mutlaka değiştirin.

API

Tüm uçlar /api altındadır. /api/auth/** herkese açıktır, geri kalanı geçerli bir JWT gerektirir. Toplam 14 yönlendirilmiş controller ve 131 uç tanımı.

Ön ek	Sorumluluk	Erişim
`/api/auth`	Giriş, kayıt	herkes
`/api/admin`	Kullanıcı yönetimi, klinik onayı, istatistikler	ADMIN
`/api/customer`	Profil, hayvanlar, randevular, tıbbi geçmiş	CUSTOMER
`/api/medical-records`	Tıbbi kayıt oluşturma ve yönetimi	VETERINARY
`/api/veterinaries`	Veteriner bilgileri	JWT
`/api/pets`, `/api/species`	Hayvan kayıtları, tür tanımları	JWT
`/api/appointments`, `/api/schedules`	Randevu ve çalışma takvimi	JWT
`/api/analyses`, `/api/vaccines`, `/api/surgeries`, `/api/prescriptions`	Tıbbi kayıt alt tipleri	JWT

Örnek — tıbbi kayıt oluşturma (Factory Pattern):

POST /api/medical-records
Authorization: Bearer <token>
Content-Type: application/json

{
  "petId": 1,
  "recordType": "ANALYSIS",
  "diagnosis": "Rutin kan tahlili",
  "temperature": 38.5,
  "heartRate": 95,
  "weight": 25.0
}

Örnek — tahlil yorumlama (Strategy Pattern):

POST /api/medical-records/1/analyze?analysisType=BLOOD_ANALYSIS

Proje yapısı

.
├── backend/                    Spring Boot REST API
│   └── src/main/java/com/example/vms_project/
│       ├── config/             uygulama yapılandırması
│       ├── controllers/        14 REST controller
│       ├── dtos/               requests / responses
│       ├── entities/           16 JPA varlığı
│       ├── patterns/           factory · observer · strategy
│       ├── repositories/       Spring Data JPA arayüzleri
│       ├── security/           JWT filtresi, SecurityConfig, başlangıç verisi
│       └── services/           iş mantığı
│
└── frontend/                   React arayüz
    └── src/
        ├── components/         ortak bileşenler, layout
        ├── contexts/           kimlik doğrulama context'i
        ├── pages/
        │   ├── admin/          kullanıcı ve klinik yönetimi
        │   ├── veterinary/     takvim, tıbbi kayıt, müşteriler
        │   └── customer/       hayvanlar, randevular, tıbbi geçmiş
        ├── services/           apiClient ve API çağrıları
        └── styles/

Gelecek çalışmalar

Proje bir yol haritasıyla ilerliyor. Maddeler önceliğe göre sıralanmıştır.

Kısa vade — kalite ve güvenlik temelleri

Test altyapısı — backend için JUnit + Testcontainers ile entegrasyon testleri, frontend için Testing Library ile bileşen testleri
API dokümantasyonu — Swagger/OpenAPI ile 131 ucun otomatik dokümantasyonu ve deneme arayüzü
Merkezî hata yönetimi — @ControllerAdvice ile controller'lardaki try/catch tekrarının kaldırılması, tutarlı hata gövdesi
Girdi doğrulama — DTO'larda Bean Validation (@Valid, @NotBlank) ile sunucu tarafı doğrulama
İlk girişte zorunlu parola değiştirme — varsayılan yönetici hesabı için
CORS yapılandırmasının ortam değişkenine taşınması — farklı ortamlarda dağıtımı mümkün kılmak için
İstemci tarafı günlük temizliği — apiClient.js içinde token içeriğini konsola yazan satırların kaldırılması
Yinelenen sayfa dosyalarının birleştirilmesi — PetListFixed.js, MedicalRecordDashboard_New.js

Orta vade — olgunlaşma

Veritabanı şema versiyonlama — ddl-auto=update yerine Flyway veya Liquibase ile denetlenebilir göç (migration) akışı
E-posta bildirimleri — randevu onayı, hatırlatma ve tıbbi kayıt bildirimlerinin e-postaya bağlanması. Altyapı hazır: Observer deseni kayıt değişikliklerini zaten yakalıyor ve spring-boot-starter-mail bağımlılığı projede mevcut; şu an bildirimler yalnızca konsola yazılıyor
Ortak bildirim ve hata mekanizması (frontend) — sayfalar arası tutarlı toast/uyarı katmanı
Yükleme durumu geri bildirimleri — istek beklenirken skeleton ve gösterge
Erişilebilirlik denetimi — klavye gezinimi, ARIA etiketleri, renk kontrastı
Rol bazlı yetkilendirmenin inceltilmesi — uç bazında daha ayrıntılı izin denetimi

Uzun vade — yeni yetenekler

Docker Compose ile tek komut kurulum — MySQL, backend ve frontend'i birlikte ayağa kaldırma
CI/CD — GitHub Actions ile derleme, test ve dağıtım hattı
Dosya yükleme — röntgen görüntüleri ve tahlil sonucu belgelerinin tıbbi kayda eklenmesi
Raporlama ve analitik — klinik doluluk oranı, gelir takibi, en sık görülen teşhisler
Mobil uyumlu arayüz / PWA — sahada tablet ve telefon kullanımı için
Çoklu klinik desteği — birden fazla şubenin tek sistem üzerinden yönetimi
Aşı takvimi hatırlatmaları — yaklaşan aşılar için otomatik uyarı

Lisans

MIT — bkz. LICENSE. Telif ekip üyelerine aittir.

Name		Name	Last commit message	Last commit date
backend		backend
frontend		frontend
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Navigation Menu

Repository files navigation

🐾 Veteriner Yönetim Sistemi

İçindekiler

Ekip

Neler yapabiliyor

👤 Hayvan sahibi (CUSTOMER)

🩺 Veteriner (VETERINARY)

⚙️ Yönetici (ADMIN)

Randevu yaşam döngüsü

Klinik onay durumları

Mimari

Tasarım desenleri

Kurulum

Gereksinimler

1. Veritabanını oluştur

2. Backend

3. Frontend

4. İlk giriş

API

Proje yapısı

Gelecek çalışmalar

Kısa vade — kalite ve güvenlik temelleri

Orta vade — olgunlaşma

Uzun vade — yeni yetenekler

Lisans

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🐾 Veteriner Yönetim Sistemi

İçindekiler

Ekip

Neler yapabiliyor

👤 Hayvan sahibi (CUSTOMER)

🩺 Veteriner (VETERINARY)

⚙️ Yönetici (ADMIN)

Randevu yaşam döngüsü

Klinik onay durumları

Mimari

Tasarım desenleri

Kurulum

Gereksinimler

1. Veritabanını oluştur

2. Backend

3. Frontend

4. İlk giriş

API

Proje yapısı

Gelecek çalışmalar

Kısa vade — kalite ve güvenlik temelleri

Orta vade — olgunlaşma

Uzun vade — yeni yetenekler

Lisans

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages