1) Amaç
Koza İnsan Kaynakları Zekâsı; organizasyon, vardiya/devam, izin ve rol bazlı verileri analiz ederek personel planlaması,
vardiya uyumu, devamsızlık trendleri, iş yükü dengesizlikleri ve operasyonel riskleri tespit eder. Üretimle ilişkili
senaryolarda (vardiya – üretim performansı gibi) çapraz analizler yapılabilir.
Bu doküman, Koza İnsan Kaynakları Zekâsı’nın çalışması için gerekli veri alanlarını ve entegrasyon ön koşullarını tanımlar.
2) Veri Kaynakları
Koza İnsan Kaynakları Zekâsı aşağıdaki sistem/modüllerden veri bekler:
- İK / Personel Yönetimi (HRIS)
- Organizasyon / Pozisyon Yönetimi
- Puantaj / Devam Takip (vardiya, giriş-çıkış)
- İzin Yönetimi
- Bordro (opsiyonel, masraf ve maliyet analizi için)
- Eğitim / Yetkinlik (opsiyonel)
- Performans / Hedef (opsiyonel)
3) Zorunlu Veri Setleri
3.1) Employees (Çalışan Kartları)
Amaç: Organizasyon ve vardiya analizleri için temel çalışan bilgileri.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| EmployeeId | Çalışan benzersiz kimliği | Evet |
| EmployeeCode | Personel sicil no | Hayır |
| FirstName | Ad | Hayır |
| LastName | Soyad | Hayır |
| DepartmentCode | Birim/Departman | Evet |
| PositionCode | Pozisyon | Hayır |
| HireDate | İşe giriş tarihi | Hayır |
| EmploymentStatus | Aktif / Pasif / Ayrıldı | Evet |
| WorkLocation | Lokasyon | Hayır |
| EmployeeType | Mavi yaka / Beyaz yaka / Taşeron vb. | Hayır |
Not (KVKK): Koza İK Zekâsı için isim/soyisim zorunlu değildir. Analizler EmployeeId üzerinden yürütülebilir.
3.2) OrganizationUnits (Organizasyon Birimleri)
Amaç: Organizasyon hiyerarşisi ve birim bazlı analizler.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| DepartmentCode | Birim kodu | Evet |
| DepartmentName | Birim adı | Hayır |
| ParentDepartmentCode | Üst birim | Hayır |
| ManagerEmployeeId | Birim yöneticisi (EmployeeId) | Hayır |
| Status | Aktif / Pasif | Hayır |
3.3) ShiftSchedules (Vardiya Planları)
Amaç: Planlanan vardiya – gerçekleşen devam karşılaştırması, kapasite planlama.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| ShiftPlanNo | Vardiya plan no | Evet |
| EmployeeId | Çalışan | Evet |
| ShiftCode | Vardiya kodu | Evet |
| PlannedStartTime | Plan başlangıç | Evet |
| PlannedEndTime | Plan bitiş | Evet |
| WorkCenterOrLine | Hat/İş merkezi (opsiyonel) | Hayır |
| Status | Planlandı / İptal | Hayır |
3.4) AttendanceRecords (Devam / Puantaj Kayıtları)
Amaç: Geç kalma, erken çıkış, devamsızlık ve fazla mesai analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| AttendanceNo | Kayıt no | Evet |
| EmployeeId | Çalışan | Evet |
| CheckInTime | Giriş zamanı | Evet |
| CheckOutTime | Çıkış zamanı | Hayır |
| Source | Kartlı geçiş / Mobil / Manuel | Hayır |
| IsOvertime | Fazla mesai (true/false) | Hayır |
| OvertimeMinutes | Fazla mesai dk | Hayır |
3.5) Leaves (İzin Kayıtları)
Amaç: İzin yoğunluğu, planlama riski, ekip bazlı kapasite etkisi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| LeaveNo | İzin no | Evet |
| EmployeeId | Çalışan | Evet |
| LeaveType | Yıllık / Rapor / Ücretsiz vb. | Evet |
| StartDate | Başlangıç | Evet |
| EndDate | Bitiş | Evet |
| Status | Onaylı / Beklemede / İptal | Hayır |
4) Opsiyonel Veri Setleri
4.1) PayrollSummaries (Bordro Özetleri)
Amaç: İş gücü maliyeti, fazla mesai maliyeti ve birim bazlı trend analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| Period | Dönem (2026-01 vb.) | Evet |
| EmployeeId | Çalışan | Evet |
| GrossAmount | Brüt | Hayır |
| NetAmount | Net | Hayır |
| EmployerCost | İşveren maliyeti | Hayır |
| Currency | Para birimi | Hayır |
4.2) Trainings (Eğitim Kayıtları)
Amaç: Yetkinlik açığı, eğitim etkisi analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| TrainingNo | Eğitim no | Evet |
| EmployeeId | Çalışan | Evet |
| TrainingName | Eğitim adı | Evet |
| TrainingDate | Tarih | Evet |
| DurationHours | Süre (saat) | Hayır |
| Result | Katıldı / Başarılı vb. | Hayır |
4.3) PerformanceReviews (Performans Değerlendirmeleri)
Amaç: Performans trendleri ve ekip bazlı risk analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| ReviewNo | Değerlendirme no | Evet |
| EmployeeId | Çalışan | Evet |
| Period | Dönem | Evet |
| Score | Puan | Hayır |
| ReviewerEmployeeId | Değerlendiren | Hayır |
| Notes | Notlar | Hayır |
5) Entegrasyon Yöntemi
Koza İnsan Kaynakları Zekâsı HRIS/ERP sistemine yazmaz; sadece okur.
- REST API
- SOAP Web Service
- Database View
- Scheduled Export (JSON/CSV)
6) Güvenlik, KVKK & Erişim Kapsamı
- Minimum veri ilkesi: Analiz için isim/soyisim gerekli değildir; EmployeeId yeterlidir.
- Önerilen kapsam: Kimlik bilgileri (TCKN, adres, sağlık vb.) paylaşılmamalıdır.
- Erişim kontrolü: Role-based access + IP whitelist + SSL/TLS önerilir.
- Loglama: Koza tarafında erişim logları tutulur (isteğe bağlı).
7) Performans & Format Beklentileri
- EmployeeId referans bütünlüğü (vardiya, devam, izin) sağlanmalı
- Zaman alanları ISO 8601 formatında olmalı
- UTF-8 karakter seti
- Devam kayıtlarında CheckInTime zorunlu, CheckOutTime mümkünse sağlanmalı
8) Hazırlık Kontrol Listesi
9) Örnek API Endpoint’leri
/api/employees
/api/organization-units
/api/shift-schedules
/api/attendance-records
/api/leaves
/api/payroll-summaries
/api/trainings
/api/performance-reviewsYetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS