142 lines
5.3 KiB
Markdown
142 lines
5.3 KiB
Markdown
# İ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 -->
|