Personel26 — Puantaj ve Nöbet Yönetim Sistemi

Sağlık kuruluşları için personel, nöbet (vardiya), puantaj, izin ve raporlama süreçlerini tek panelden yöneten web uygulaması. Next.js 16 (App Router) + PostgreSQL (Drizzle ORM).

Özellikler

• Puantaj — Hafta sekmeli aylık cetvel; işçi/memur/hemşire sınıflarına göre otomatik net saat (İş Kanunu M.68 mola düşümü: 8s→7,5 · 12s→11), kod (G/G2/N/N2/B/İ/R/ÜY) veya serbest saat girişi, hafta sonu ×1,5 / bayram ×2 / gece mesaisi özetleri, haftalık elle düzeltme, Excel/CSV/PDF çıktısı, imza alanları
• Nöbet Çizelgesi — Gün × "Hizmet (Saat)" sütunlu ızgara; sütun ekle/düzenle/sırala, her ay kendi düzenini korur, atamalar puantaja anında işlenir, çakışma + 11 saat dinlenme uyarıları, izinli personel koruması, dengeli otomatik taslak
• Vardiya Şablonları — Sütun düzenini kaydet, tek tıkla "İşle": düzeni kur + ayı adil dağıtımla doldur
• İzin Yönetimi — 9 izin türü, 3 aşamalı onay akışı (Hemşire → Müdür → Başhekim), onaylanan izin puantaja otomatik yansır
• Personel Yönetimi — Ekleme/düzenleme, çoklu departman ataması (★ ana departman), İşçi/Memur/Hemşire sınıfları, profil fotoğrafı (otomatik 256px kırpma), izin bakiyeleri, arama/filtre, Excel çıktısı
• Analiz & Uyarılar — Son 6 ay Gini tabanlı adalet skoru + grafikler; 11 saat dinlenme, ardışık nöbet, haftalık 45/40 saat ve gece limiti kontrolleri
• Değişim Talepleri — Nöbet takası/devri, onayda otomatik uygulanır
• Yedekleme — Günlük otomatik + manuel yedek, tek tıkla geri yükleme (öncesinde güvenlik yedeği), JSON indirme, son 30 yedek
• /personel — Şifresiz, salt-okunur personel sorgu ekranı (TC + soyad doğrulamalı, hız sınırlı)

Geliştirme Ortamı

Gereksinimler: Node.js 20+, PostgreSQL 14+

git clone https://github.com/KULLANICI/personel26.git
cd personel26
npm install
cp .env.example .env        # DATABASE_URL'i kendi PostgreSQL'inize göre düzenleyin
npx drizzle-kit push        # tabloları oluşturur
npm run dev                 # http://localhost:3000

Üretim: npm run build && npm start

• next build artık DATABASE_URL olmadan da tamamlanır (CI/Windows paketleme için).
• Uygulamayı çalıştırırken veritabanı gerekir: .env dosyasında DATABASE_URL tanımlayın.
• GitHub Pages'te panelin tamamı çalışır: tarayıcı içi PostgreSQL (PGlite/WASM) sayesinde sunucu gerekmez, veriler tarayıcıda (IndexedDB) saklanır. Kurulum: WEB-YAYINLAMA.md.
• Kurumda birden çok kişi aynı veriyi kullanacaksa Vercel + Neon (sunucu tarafı PostgreSQL) kurulumunu kullanın.
• İlk açılışta örnek veriler (3 servis, 15 personel, 6 aylık nöbet geçmişi) otomatik yüklenir.

Web'de Yayınlama (GitHub Pages / Vercel)

• GitHub Pages → panelin tamamı (sunucusuz; veritabanı tarayıcıda çalışır)
• Vercel + Neon → ortak veritabanlı, çok kullanıcılı canlı sistem

Adım adım kurulum: WEB-YAYINLAMA.md

⚠ GitHub Pages'in paneli yayınlaması için depo ayarında Settings → Pages → Build and deployment → Source: GitHub Actions seçili olmalıdır. "Deploy from a branch" seçiliyken GitHub yalnızca bu README dosyasını gösterir.

Windows Paketi (Portable + Kurulum)

Son kullanıcı bilgisayarları için tek tıkla çalışan paket:

powershell -ExecutionPolicy Bypass -File windows\paket-olustur.ps1

Ayrıntılar ve Personel26-Kurulum.exe üretimi için: windows/README-WINDOWS.md

Proje Yapısı

src/
├── app/                # Next.js sayfaları + API route'ları (REST)
│   ├── api/            # timesheet, roster, leaves, personnel, export, backup…
│   └── personel/       # şifresiz personel sorgu ekranı
├── components/         # Puantaj, Nöbet, Şablon, İzin, Personel… sayfaları
├── lib/
│   ├── puantaj-engine.ts   # saat/mola/kod hesap motoru
│   ├── roster-conflicts.ts # çakışma + dinlenme kuralları
│   └── server/             # seed, senkron, dışa aktarma, sütun yönetimi
└── db/schema.ts        # Drizzle ORM şeması (13 tablo)
windows/                # taşınabilir paket + Inno Setup kurulum scriptleri
scripts/                # tarayıcı testleri, arayüz önizleme üretici

Testler

node scripts/browser-test.mjs            # gerçek Chrome: yükleme + tüm sayfa geçişleri
node scripts/browser-test-clockskew.mjs  # saat farkı senaryosunda hidrasyon güvenliği

Lisans

Kurum içi kullanım için geliştirilmiştir.

Ayarlar ve toplu aktarım — 1.1.0

Sol menüde Ayarlar: kurum bilgileri/logo, korunmuş ana tema + 20 alternatif, Excel/CSV aktarımı, yedekleme ve veritabanı işlemleri, bildirimler ve sistem durumu. Personel Yönetimi içinden de Excel/CSV aktarımı açılabilir.

Ayrıntılar, test komutları ve dağıtım sınırları: GELISTIRME-NOTLARI.md. Windows kurulum/güncelleme/SQL geri yükleme ve Actions testleri: windows/README-WINDOWS.md.

GitHub Pages komutlarını doğrudan node scripts/pages-build.mjs ve node scripts/pages-smoke-test.mjs ile çalıştırabilirsiniz. Şema değişiminde tarayıcı veritabanının kullanıcı verileri artık otomatik sıfırlanmaz.

Windows testleri Linux geliştirme ortamında çalıştırılmadı; depo GitHub’a gönderildikten sonra gerçek Actions sonuçları ayrıca incelenmelidir. Panel içindeki Windows durumu bu nedenle bekliyor olarak görünür.