5.3 KiB
İK › Olay Günlüğü (App.Hr.EventLog)
Vardiya amiri, güvenlik odası ve gözlem odasının tuttuğu vardiya defteri: tarih–saat, kaynak, olayı yaşayan/kaydeden personel, vardiya, önem derecesi (1–5) ve açıklama. Tamamı konfigürasyondur (tek Wizard ekranı).
Bu doküman modülün tek "nasıl çalışır" kaynağıdır. Modülde yapılan her değişiklik aynı commit'te buraya yansır (
lowcode.instructions.md§0.13).
1. Amaç ve kapsam
| Persona | Ne yapar | Ekran |
|---|---|---|
| Vardiya amiri / güvenlik / gözlem odası | Vardiyada yaşanan önemli olayları kaydeder | Olay Günlüğü |
| Yönetim / İK | Günün olaylarını ve önemli/kritik kayıtları izler; gerekirse disiplin dosyası açar | Olay Günlüğü (widget, Pivot) |
Kapsam: kiracı (IsTenant). Şube isteğe bağlıdır; satır süzmesi yoktur.
2. Analiz ve kararlar
Modül §0.13 kuralından önce üretildi; keşif turu kaydı yoktur. Kararlar wizard ve SQL'den okunmuştur.
| Konu | Karar |
|---|---|
| Yol | Tek Wizard liste ekranı |
| Kaynak | Sabit liste: Vardiya Amiri (ShiftSupervisor), Güvenlik Odası (SecurityRoom), Gözlem Odası (ObservationRoom) |
| Önem | 1–5 yıldız: Rutin, Düşük, Önemli, Çok Önemli, Kritik; 4 ve üstü "önemli" kartında sayılır |
| Saat | EventTime SS:dd metin; yeni kayıtta şimdiki saat |
| Vardiya | Vardiya tanımından seçilir (Hr_T_Shift) |
| Disiplin bağı | Olaydan disiplin dosyasına otomatik geçiş yoktur; dosya elle açılır |
3. Menü ve ekran
| Menü (TR / EN) | ListFormCode |
Yer | Görünümler | Widget'lar |
|---|---|---|---|---|
| Olay Günlüğü / Event Log | App.Hr.EventLog |
İnsan Kaynakları (sıra 9, FcViewDetails) |
Grid, Card, Pivot, Chart | Toplam · Bugün · Önemli (önem ≥ 4) |
4. Veri modeli
Hr_T_EventLog (sql/object/Hr_T_EventLog.sql, entity yok):
| Kolon | Açıklama |
|---|---|
LogSource |
Kayıt kaynağı (zorunlu) |
BranchId |
Şube |
UserId |
Vardiya amiri / olayı yaşayan personel (zorunlu) |
EventDate, EventTime |
Olay tarihi ve saati (zorunlu) |
Importance |
1–5 (varsayılan 1) |
ShiftId |
Vardiya |
Description |
Açıklama |
5. İş kuralları
| Yer | Kural |
|---|---|
| Yeni kayıt | Olay saati boşsa şimdiki saat yazılır |
| Önem kartı | Importance >= 4 |
6. Yetki ve görünürlük
İzin grubu App.Hr, modül Sas|Hr; App.Hr.EventLog + .Create/.Update/.Delete/.Export/.Import/.Note.
Kayıt tutanlara kök + .Create (ve gerekiyorsa .Update) yeter; silme yalnız yöneticide kalmalıdır.
Hiçbir yetki role otomatik atanmaz.
7. Entegrasyonlar
Sas_T_Branch, AbpUsers, Hr_T_Shift (bkz. HrWorkCalendar.md). Kritik olay için bildirim yoktur.
8. Akış örneği
- Gece vardiyasında güvenlik odası "B kapısı alarmı" olayını kaynak Güvenlik Odası, önem 3, vardiya Gece ile kaydeder.
- Vardiya amiri bir iş kazasını önem 5 ile girer → "Önemli" kartı artar.
- Sabah İK önemli kayıtları süzer; gerekiyorsa Disiplin Dosyaları'nda elle dosya açar.
9. Sık sorulanlar
Kritik olayda yöneticiye bildirim gidiyor mu? Hayır; widget ve filtre ile izlenir.
Olay disiplin dosyasına bağlanabiliyor mu? Hayır; iki kayıt arasında bağ yoktur.
10. Dosyalar ve geri alma
| Dosya | İçerik |
|---|---|
configs/seeds/host/sql/object/Hr_T_EventLog.sql |
Tablo |
configs/seeds/host/wizard/EventLog.json |
Wizard |
Geri alma: Wizard Manager'dan silinir; tablo yalnızca onayda seçilirse düşer.
Ek — Ekran envanteri (otomatik)
Wizard dosyalarından üretilir; deploy, silme, tasarımcı kaydı ve import'ta yenilenir. Elle düzenleme bir sonraki yenilemede kaybolur.
Olay Günlüğü — App.Hr.EventLog
| Özellik | Değer |
|---|---|
| Wizard | wizard/EventLog.json |
| Yol | Liste (Wizard) |
| Menü | App.Hr › App.Hr.EventLog (sıra 7) |
| Yetki | App.Hr.EventLog + .Create, .Update, .Delete, .Export, .Import, .Note |
| Açıklama | Olay Günlüğü — vardiya amiri, güvenlik odası ve gözlem odasının vardiya sırasında kaydettiği önemli olaylar. |
| Geliştirme talebi | Human Resources -> Olay Günlüğü |
| Kaynak | Hr_T_EventLog · filtre "IsDeleted" = 'false' |
| Görünümler | Grid, Card, Pivot, Chart (açılış grid) |
| Düzenleme | ekle ✓ · düzenle ✓ · sil ✓ · popup |
| Kapsam | Kiracı |
| Widget'lar | App.Widget.Total, App.Widget.Today, App.Hr.EventLog.Widget.Important |
| Alan | Başlık | Editör | Zorunlu | Formda | Kaynak |
|---|---|---|---|---|---|
LogSource |
Kaynak | dxSelectBox | ✓ | ✓ | liste: ShiftSupervisor, SecurityRoom, ObservationRoom |
BranchId |
Şube Adı | dxSelectBox | ✓ | sorgu: Sas_T_Branch | |
UserId |
Vardiya Amiri / Olayı Yaşayan | dxSelectBox | ✓ | ✓ | sorgu: AbpUsers |
EventDate |
Olay Tarihi | dxDateBox | ✓ | ✓ | script |
EventTime |
Olay Saati | dxTextBox | ✓ | ✓ | |
Importance |
Önem Durumu | dxSelectBox | ✓ | ✓ | liste: 1, 2, 3, 4, 5 |
ShiftId |
Vardiya | dxSelectBox | ✓ | sorgu: Hr_T_Shift | |
Description |
Açıklama | dxTextArea | ✓ |