Payroll / Timesheet — Dữ liệu & bảng đọc/ghi

Góc nhìn database và khái niệm ngoài mà Payroll/Timesheet đọc/ghi. Quy ước: 📖 READ, ✏️ WRITE (insert/update).

Dữ liệu đọc ghi

Mảng	Dữ liệu
Payroll settings	BusinessUnitSetting.DefaultPaidHoursOptionId 📖 READ lúc load form; ✏️ WRITE khi save (route /api/BusinessUnitSetting/Payroll, quyền SettingFinance).
Tạo ca Staff Attendance	OrgEmployee ✏️ WRITE khi thiếu link active (auto-fix); 📖 READ để resolve/tái dùng.
Link trên ca	Shift.OrgEmployeeId ✏️ WRITE gán vào OrgEmployee đã đảm bảo.
Trạng thái dòng ca	Shift.TimesheetStatusId, Shift.Exported ✏️ WRITE (approve/un-approve/export/un-export).
Trạng thái dòng leave-only	EmployeeAbsence.TimesheetStatusId, EmployeeAbsence.Exported ✏️ WRITE — dòng nghỉ không ca dùng trạng thái trên chính absence.
Leave-only source	EmployeeAbsence 📖 READ — Date, TimeStart/TimeEnd, tracking code, lifecycle approved.
Leave overlap	EmployeeAbsence 📖 READ, giao interval với Shift để tính Leave Hours + leave Tracking Code.
Tracking code	TrackingCode / ShiftTrackingCode 📖 READ — cột Tracking Code (ca) và (leave) trong export.
Export dataset	Shift + EmployeeAbsence 📖 READ re-query theo id dưới BU/org scope.

Nguồn dữ liệu khác

Nguồn	Vai trò
jsReport Reporting Server	Render template theo ReportCode → CSV stream; backend build dataset + pre-format trước.
SettingFinance permission	Ranh giới ghi payroll settings; DefaultPaidHoursOptionId không writable qua route thiếu quyền.
STAFF_ROSTER	Gate hiển thị/bảo vệ tab Payroll trong Finance Settings.

Dữ liệu từ domain khác

Domain	Payroll/Timesheet đọc để làm gì
Staff	Shift, EmployeeAbsence, tracking code, chấm công (ShiftClock) — nguồn dòng timesheet.
Master Data	Employee / OrgEmployee — link staff–site cho Shift.OrgEmployeeId; auto-link staff khi tạo.
Finance	Settings → Finance — nơi gắn tab Payroll (sau Subsidy Settings).

Liên quan

• Kiến trúc & dữ liệu — flow export server-side, column contract, guardrails.
• Staff — roster, leave và tracking code.