# İ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 13, `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

1. Gece vardiyasında güvenlik odası "B kapısı alarmı" olayını kaynak Güvenlik Odası, önem 3, vardiya Gece ile kaydeder.
2. Vardiya amiri bir iş kazasını önem 5 ile girer → "Önemli" kartı artar.
3. 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/sql/object/Hr_T_EventLog.sql` | Tablo |
| `configs/seeds/wizard/EventLog.json` | Wizard |

Geri alma: Wizard Manager'dan silinir; tablo yalnızca onayda seçilirse düşer.

<!-- module-doc:auto:begin -->
## 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 13) |
| 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 |  | ✓ |  |

<!-- module-doc:auto:end -->