# 2. SƠ ĐỒ THỰC THỂ (ERD)

**Quy ước đọc sơ đồ**

| Ký hiệu | Ý nghĩa |
|---|---|
| `||--o{` nét liền | FK thật **trong cùng schema/service** |
| `..` nét đứt | Tham chiếu **xuyên service** bằng ID thuần, không có FK, đồng bộ qua event/API |
| `|o` / `o{` | Quan hệ **tuỳ chọn** (0..1 / 0..n) |
| `||` / `|{` | Quan hệ **bắt buộc** (đúng 1 / 1..n) |
| `PK` `FK` `UK` | Khoá chính / khoá ngoại cùng schema / duy nhất |
| `"ref X"` | Cột tham chiếu sang service khác (không có FK) |
| Kiểu `TSTZ` | `TIMESTAMP WITH TIME ZONE` |

**Mục lục**

| Mục | Phạm vi | Trạng thái |
|---|---|---|
| 2.0 | Tổng quan toàn hệ thống (flowchart theo service) | — |
| 2.1 | CoreHR — `HR_CORE` (21 bảng, v3 theo thời gian) | ✅ Khớp 1-1 với [00_Init_Oracle_Schema.sql](00_Init_Oracle_Schema.sql) |
| 2.2 | Recruitment — `HR_ATS` (7 bảng) | ✅ Khớp 1-1 với SQL |
| 2.3 | Payroll — `HR_PAY` (6 bảng) | ✅ Khớp 1-1 với SQL |
| 2.4 | Workflow — `HR_WF` (8 bảng) | ✅ Khớp 1-1 với SQL |
| 2.5 | Hợp đồng lao động (mở rộng CoreHR) | 📝 Logic — chưa có trong SQL |
| 2.6 | Time & Attendance — `HR_TA` | 📝 Logic |
| 2.7 | Talent — `HR_TAL` (Performance, L&D, Succession) | 📝 Logic |
| 2.8 | Offboarding & Asset — `HR_OFF` | 📝 Logic |
| 2.9 | Identity & RBAC — `HR_IAM` | 📝 Logic |
| 2.10 | Nhật ký thay đổi so với v1 | — |

Các mục **Logic** dùng cùng quy ước với phần đã có SQL: có `TenantId`, dữ liệu theo thời gian dùng
`[ValidFrom, ValidTo)`, và mọi tham chiếu sang service khác đều là ID thuần.

---

## 2.0 Tổng quan toàn hệ thống

Sơ đồ tổng quan dùng **flowchart có khung theo service**, không dùng erDiagram. Lý do: gần như mọi service đều tham
chiếu `EMPLOYEE`, nên vẽ từng đường sẽ ra một mớ dây rối. Ở đây:
- Mũi tên liền là FK trong cùng schema (chiều cha → con).
- Mũi tên nét đứt là tham chiếu xuyên service, gộp thành một mũi tên cho mỗi service và ghi rõ cột tham chiếu.
- Viền tím là bảng đã có SQL; viền cam là bảng logic.

Cardinality và cột chi tiết xem ở các mục 2.1 → 2.9. `OUTBOX_MESSAGE` và `INBOX_MESSAGE` có ở mọi schema nên được lược bỏ.

```mermaid
flowchart TB
    subgraph CORE["CoreHR · HR_CORE"]
        CHANGE_SET --> CHANGE_ITEM
        TENANT --> LEGAL_ENTITY
        JOB_GRADE --> JOB_TITLE
        ORG_UNIT --> ORG_UNIT_VERSION
        ORG_UNIT -->|child / parent| ORG_EDGE
        ORG_UNIT --> ORG_UNIT_HEAD
        POSITION --> POSITION_VERSION
        POSITION --> POSITION_MATRIX_LINE
        ORG_UNIT --> POSITION_VERSION
        JOB_TITLE --> POSITION_VERSION
        POSITION --> ORG_UNIT_HEAD
        LEGAL_ENTITY --> ORG_UNIT_VERSION
        EMPLOYEE --> EMPLOYEE_PROFILE
        EMPLOYEE --> EMPLOYMENT
        LEGAL_ENTITY --> EMPLOYMENT
        EMPLOYMENT --> EMPLOYMENT_VERSION
        EMPLOYMENT --> ASSIGNMENT
        POSITION --> ASSIGNMENT
        EMPLOYMENT --> EMPLOYMENT_CONTRACT
        EMPLOYMENT_CONTRACT --> CONTRACT_AMENDMENT
        ORG_PATH_CURRENT
    end

    subgraph ATS["Recruitment · HR_ATS"]
        JOB_REQUISITION --> APPLICATION
        CANDIDATE --> APPLICATION
        APPLICATION --> INTERVIEW_SCHEDULE
        APPLICATION --> OFFER_LETTER
    end

    subgraph PAY["Payroll · HR_PAY"]
        PAYROLL_PERIOD --> PAYSLIP
        PAYSLIP --> PAYSLIP_DETAIL
        PAYROLL_PERIOD -->|retro for| PAYSLIP_DETAIL
        SALARY_COMPONENT
        RETRO_TRIGGER
    end

    subgraph WF["Workflow · HR_WF"]
        WORKFLOW_TEMPLATE --> WORKFLOW_STEP_DEF
        WORKFLOW_TEMPLATE --> APPROVAL_REQUEST
        APPROVAL_REQUEST --> APPROVAL_TASK
        APPROVAL_REQUEST --> APPROVAL_LOG
        APPROVAL_TASK --> APPROVAL_LOG
        DELEGATION
        AUTHORITY_MATRIX
    end

    subgraph TA["Time & Attendance · HR_TA"]
        SHIFT --> SHIFT_ASSIGNMENT
        LEAVE_TYPE --> LEAVE_BALANCE
        LEAVE_TYPE --> LEAVE_REQUEST
        HOLIDAY_CALENDAR --> HOLIDAY_DATE
        ATTENDANCE_RECORD
        OVERTIME_REQUEST
    end

    subgraph TAL["Talent · HR_TAL"]
        REVIEW_CYCLE --> GOAL
        REVIEW_CYCLE --> PERFORMANCE_REVIEW
        REVIEW_CYCLE --> NINE_BOX_ASSESSMENT
        GOAL --> KEY_RESULT
        COURSE --> CLASS_SESSION
        CLASS_SESSION --> ENROLLMENT
        ENROLLMENT --> CERTIFICATE
        SUCCESSION_PLAN --> SUCCESSION_CANDIDATE
    end

    subgraph OFF["Offboarding · HR_OFF"]
        ASSET_INVENTORY --> ASSET_ASSIGNMENT
        RESIGNATION_REQUEST --> HANDOVER_TASK
        ASSET_ASSIGNMENT --> HANDOVER_TASK
    end

    subgraph IAM["Identity · HR_IAM"]
        APP_USER --> USER_ROLE
        APP_ROLE --> USER_ROLE
        APP_ROLE --> ROLE_PERMISSION
        USER_ROLE --> ROLE_SCOPE
    end

    ATS -. "PositionId · OfferAccepted" .-> CORE
    CORE -. "ChangeSetApplied (retroactive)" .-> PAY
    PAY -. EmployeeId .-> CORE
    WF -. "EmployeeId · PositionId (gRPC DOA)" .-> CORE
    TA -. EmployeeId .-> CORE
    TAL -. "EmployeeId · PositionId" .-> CORE
    OFF -. EmployeeId .-> CORE
    IAM -. "EmployeeId · OrgUnitId" .-> CORE
    ATS -. ApprovalRequestId .-> WF
    TA -. ApprovalRequestId .-> WF
    OFF -. ApprovalRequestId .-> WF

    classDef sql fill:#18243F,stroke:#6366F1,color:#E2E8F0
    classDef logic fill:#1E1A12,stroke:#B45309,color:#FDE68A
    class TENANT,LEGAL_ENTITY,CHANGE_SET,CHANGE_ITEM,JOB_GRADE,JOB_TITLE,ORG_UNIT,ORG_UNIT_VERSION,ORG_EDGE,ORG_UNIT_HEAD,ORG_PATH_CURRENT sql
    class POSITION,POSITION_VERSION,POSITION_MATRIX_LINE,EMPLOYEE,EMPLOYEE_PROFILE,EMPLOYMENT,EMPLOYMENT_VERSION,ASSIGNMENT sql
    class JOB_REQUISITION,CANDIDATE,APPLICATION,INTERVIEW_SCHEDULE,OFFER_LETTER sql
    class PAYROLL_PERIOD,PAYSLIP,PAYSLIP_DETAIL,SALARY_COMPONENT,RETRO_TRIGGER sql
    class WORKFLOW_TEMPLATE,WORKFLOW_STEP_DEF,APPROVAL_REQUEST,APPROVAL_TASK,APPROVAL_LOG,DELEGATION,AUTHORITY_MATRIX sql
    class EMPLOYMENT_CONTRACT,CONTRACT_AMENDMENT logic
    class SHIFT,SHIFT_ASSIGNMENT,LEAVE_TYPE,LEAVE_BALANCE,LEAVE_REQUEST,HOLIDAY_CALENDAR,HOLIDAY_DATE,ATTENDANCE_RECORD,OVERTIME_REQUEST logic
    class REVIEW_CYCLE,GOAL,KEY_RESULT,PERFORMANCE_REVIEW,NINE_BOX_ASSESSMENT,COURSE,CLASS_SESSION,ENROLLMENT,CERTIFICATE,SUCCESSION_PLAN,SUCCESSION_CANDIDATE logic
    class ASSET_INVENTORY,ASSET_ASSIGNMENT,RESIGNATION_REQUEST,HANDOVER_TASK logic
    class APP_USER,APP_ROLE,ROLE_PERMISSION,USER_ROLE,ROLE_SCOPE logic
```

---

## 2.1 CoreHR — `HR_CORE` (21 bảng, v3 theo thời gian)

Mẫu chung của v3 là **bảng định danh (bất biến) → bảng phiên bản bitemporal**. Phiên bản có
`ValidFrom/ValidTo` (hiệu lực) + `RecordedAt/SupersededAt` (hiểu biết) + `ChangeSetId` (quyết định sinh ra nó).
Sơ đồ chia hai phần: **2.1a cơ cấu tổ chức** và **2.1b nhân sự & quyết định**.

### 2.1a Cơ cấu tổ chức — đơn vị, cây, trưởng đơn vị, ghế

```mermaid
erDiagram
    TENANT ||--o{ LEGAL_ENTITY : owns
    TENANT ||--o{ ORG_UNIT : owns
    TENANT ||--o{ JOB_GRADE : owns
    JOB_GRADE ||--o{ JOB_TITLE : grades
    ORG_UNIT ||--|{ ORG_UNIT_VERSION : "versions (ten, loai, phap nhan)"
    LEGAL_ENTITY ||--o{ ORG_UNIT_VERSION : "unit belongs to"
    ORG_UNIT ||--o{ ORG_EDGE : "is child in"
    ORG_UNIT |o--o{ ORG_EDGE : "is parent in"
    ORG_UNIT ||--o{ ORG_UNIT_HEAD : "headed by (theo thoi gian)"
    POSITION ||--o{ ORG_UNIT_HEAD : "is head seat"
    POSITION ||--|{ POSITION_VERSION : "versions (don vi, FTE, bao cao)"
    ORG_UNIT ||--o{ POSITION_VERSION : "contains seat"
    JOB_TITLE ||--o{ POSITION_VERSION : "defines role"
    POSITION |o--o{ POSITION_VERSION : "explicit reports-to"
    POSITION ||--o{ POSITION_MATRIX_LINE : "has dotted line"
    POSITION ||--o{ POSITION_MATRIX_LINE : "is dotted target"
    ORG_UNIT ||--o{ ORG_PATH_CURRENT : "cache hom nay"
    CHANGE_SET ||--o{ ORG_UNIT_VERSION : "produced"
    CHANGE_SET ||--o{ ORG_EDGE : "produced"
    CHANGE_SET ||--o{ POSITION_VERSION : "produced"

    TENANT {
        RAW16 Id PK
        VARCHAR2 Code UK
        VARCHAR2 Name
        NUMBER OrgVersion "tang moi lan ap change set"
        VARCHAR2 HeadcountPolicy "HARD WARN"
        TSTZ CreatedAt
    }
    LEGAL_ENTITY {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Code UK
        VARCHAR2 Name
        VARCHAR2 TaxCode
        CHAR CountryCode
        VARCHAR2 Status "ACTIVE DISSOLVED"
        TSTZ CreatedAt
    }
    JOB_GRADE {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Code UK "L1 L2 M1 M2 E1"
        VARCHAR2 Name
        NUMBER GradeRank "so sanh cap cho DOA"
    }
    JOB_TITLE {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Code UK
        VARCHAR2 TitleName
        VARCHAR2 JobFamily
        RAW16 JobGradeId FK
        VARCHAR2 Status "ACTIVE RETIRED"
        TSTZ CreatedAt
    }
    ORG_UNIT {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Code UK "bat bien"
        RAW16 CreatedByChangeSetId FK
        TSTZ CreatedAt
    }
    ORG_UNIT_VERSION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 OrgUnitId FK
        VARCHAR2 Name
        VARCHAR2 ShortName
        VARCHAR2 OrgType "GROUP COMPANY DIVISION DEPARTMENT TEAM BRANCH"
        RAW16 LegalEntityId FK
        VARCHAR2 CostCenterCode
        VARCHAR2 LocationCode
        DATE ValidFrom
        DATE ValidTo "khong co phien ban = giai the"
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    ORG_EDGE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 HierarchyType "MANAGEMENT LEGAL FINANCIAL"
        RAW16 ChildId FK
        RAW16 ParentId FK "NULL = goc"
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    ORG_UNIT_HEAD {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 OrgUnitId FK
        RAW16 PositionId "ghe truong don vi"
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    ORG_PATH_CURRENT {
        RAW16 TenantId
        VARCHAR2 HierarchyType PK
        RAW16 OrgUnitId PK
        RAW16 ParentId
        VARCHAR2 Lineage "cache hom nay, dung lai duoc"
        NUMBER Depth
        DATE AsOfDate
        TSTZ RefreshedAt
    }
    POSITION {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Code UK
        RAW16 CreatedByChangeSetId FK
        TSTZ CreatedAt
    }
    POSITION_VERSION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 PositionId FK
        RAW16 OrgUnitId FK
        RAW16 JobTitleId FK
        NUMBER FteBudget "dinh bien FTE"
        BOOLEAN IsManager
        VARCHAR2 ReportingMode "INHERIT EXPLICIT"
        RAW16 ExplicitReportsToPositionId FK
        VARCHAR2 Status "ACTIVE FROZEN"
        VARCHAR2 CostCenterOverride
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    POSITION_MATRIX_LINE {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 PositionId FK
        RAW16 ReportsToPositionId FK
        VARCHAR2 LineType "FUNCTIONAL PROJECT ADMINISTRATIVE"
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
```

### 2.1b Nhân sự và quyết định — pháp nhân, quan hệ lao động, bổ nhiệm, change set

```mermaid
erDiagram
    CHANGE_SET ||--|{ CHANGE_ITEM : "gom cac thao tac"
    CHANGE_SET |o--o| CHANGE_SET : "reversed by"
    EMPLOYEE ||--o| EMPLOYEE_PROFILE : "PII 1-0..1"
    EMPLOYEE ||--o{ EMPLOYMENT : "lam cho phap nhan"
    LEGAL_ENTITY ||--o{ EMPLOYMENT : "employer"
    EMPLOYMENT ||--|{ EMPLOYMENT_VERSION : "versions (loai HD, nghi viec)"
    EMPLOYMENT ||--o{ ASSIGNMENT : "bo nhiem trong"
    EMPLOYEE ||--o{ ASSIGNMENT : holds
    POSITION ||--o{ ASSIGNMENT : "occupied by"
    CHANGE_SET ||--o{ EMPLOYMENT_VERSION : "produced"
    CHANGE_SET ||--o{ ASSIGNMENT : "produced"

    CHANGE_SET {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 Kind "ORG PERSONNEL CORRECTION"
        VARCHAR2 Title
        VARCHAR2 DecisionNo "so quyet dinh"
        DATE EffectiveDate
        VARCHAR2 Status "DRAFT VALIDATED PENDING_APPROVAL APPROVED APPLIED NEEDS_REVALIDATION CANCELLED REVERSED"
        NUMBER BaseOrgVersion
        TSTZ ValidatedAt
        JSON ValidationReport
        BOOLEAN HeadcountOverride
        VARCHAR2 OverrideReason
        RAW16 ApprovalRequestId "ref HR_WF"
        TSTZ AppliedAt
        NUMBER AppliedOrgVersion
        RAW16 ReversedByChangeSetId FK
        VARCHAR2 CreatedBy
        TSTZ CreatedAt
        NUMBER RowVersion
    }
    CHANGE_ITEM {
        RAW16 Id PK
        RAW16 ChangeSetId FK
        NUMBER Seq UK
        VARCHAR2 Op "CREATE_UNIT MOVE_UNIT SET_UNIT_HEAD ASSIGN TERMINATE ..."
        VARCHAR2 TargetType "ORG_UNIT POSITION EMPLOYEE EMPLOYMENT ASSIGNMENT"
        RAW16 TargetId
        DATE EffectiveDate "NULL = theo change set"
        JSON Payload
        VARCHAR2 Result "OK WARNING ERROR"
        VARCHAR2 Message
    }
    EMPLOYEE {
        RAW16 Id PK
        RAW16 TenantId FK
        VARCHAR2 EmployeeCode UK "giu nguyen khi tuyen lai"
        VARCHAR2 FullName
        VARCHAR2 WorkEmail UK
        RAW16 SourceCandidateId UK "ref HR_ATS, idempotent hire"
        TSTZ CreatedAt
    }
    EMPLOYEE_PROFILE {
        RAW16 EmployeeId PK, FK
        RAW16 TenantId
        VARCHAR2 PersonalEmail
        VARCHAR2 Phone
        DATE DateOfBirth
        VARCHAR2 NationalId UK "TDE"
        VARCHAR2 TaxCode "TDE"
        VARCHAR2 SocialInsNo "TDE"
        VARCHAR2 BankAccNumber "TDE"
        VARCHAR2 BankCode
        TSTZ UpdatedAt
    }
    EMPLOYMENT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId FK
        RAW16 LegalEntityId FK
        VARCHAR2 EmploymentNo UK
        RAW16 CreatedByChangeSetId FK
        TSTZ CreatedAt
    }
    EMPLOYMENT_VERSION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmploymentId FK
        VARCHAR2 EmploymentType "PERMANENT FIXED_TERM PROBATION INTERN CONTRACTOR"
        DATE SeniorityDate
        DATE ValidFrom
        DATE ValidTo "NULL = dang lam"
        VARCHAR2 EndReason
        TSTZ RecordedAt
        TSTZ SupersededAt
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    ASSIGNMENT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 AssignmentKey "dinh danh logic qua cac phien ban"
        RAW16 EmploymentId FK
        RAW16 EmployeeId FK
        RAW16 PositionId FK
        VARCHAR2 AssignmentType "PRIMARY CONCURRENT ACTING SECONDMENT"
        NUMBER Fte "0 < Fte <= 1"
        DATE ValidFrom
        DATE ValidTo
        VARCHAR2 StartReason
        VARCHAR2 EndReason
        TSTZ RecordedAt
        TSTZ SupersededAt
        VARCHAR2 RecordedBy
        RAW16 ChangeSetId FK
        RAW16 SupersededByChangeSetId FK "quyet dinh da thay the dong (V4)"
    }
    OUTBOX_MESSAGE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 AggregateType
        RAW16 AggregateId
        VARCHAR2 EventType
        JSON Payload
        TSTZ OccurredAt
        TSTZ PublishedAt "NULL = chua day"
    }
    INBOX_MESSAGE {
        RAW16 MessageId PK
        VARCHAR2 Consumer PK
        TSTZ ProcessedAt
    }
```

Bất biến quan trọng không thể hiện được trên sơ đồ (chi tiết 04 §4.5):
- Mọi bảng `*_VERSION`, `ORG_EDGE`, `ORG_UNIT_HEAD`, `POSITION_MATRIX_LINE`, `ASSIGNMENT`: **bất biến**, chỉ set
  `SupersededAt` một lần (trigger `TRG_*_IMM` + quyền cột).
- Không 2 phiên bản hiện hành chồng khoảng trên cùng đối tượng; mỗi đơn vị tối đa 1 cha / loại cây và 1 trưởng
  tại mỗi ngày; không vòng trong cây và trong chuỗi báo cáo; mỗi người tối đa 1 ghế PRIMARY tại mỗi ngày;
  tổng FTE ≤ định biên tại mọi mốc — `PKG_INTEGRITY.VerifyChangeSet` trước commit.
- Chuỗi báo cáo **không lưu**: suy ra bởi `PKG_ORG_QUERY.ManagerPosition` từ `ORG_UNIT_HEAD` + `ORG_EDGE` + `POSITION_VERSION`.

---

## 2.2 Recruitment — `HR_ATS` (7 bảng)

```mermaid
erDiagram
    JOB_REQUISITION ||--o{ APPLICATION : receives
    CANDIDATE ||--o{ APPLICATION : submits
    APPLICATION ||--o{ INTERVIEW_SCHEDULE : "has rounds"
    APPLICATION ||--o{ OFFER_LETTER : "may get"
    JOB_REQUISITION }o..|| POSITION : "fills seat (ref HR_CORE)"
    INTERVIEW_SCHEDULE }o..|| EMPLOYEE : "interviewer (ref HR_CORE)"
    OFFER_LETTER |o..o| EMPLOYEE : "becomes (event)"
    JOB_REQUISITION |o..o| APPROVAL_REQUEST : "approved by (ref HR_WF)"
    OFFER_LETTER |o..o| APPROVAL_REQUEST : "approved by (ref HR_WF)"

    JOB_REQUISITION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 PositionId "ref HR_CORE.POSITION"
        NUMBER Openings ">= 1"
        VARCHAR2 Status "DRAFT PENDING_APPROVAL OPEN ON_HOLD FILLED CANCELLED"
        RAW16 ApprovalRequestId "ref HR_WF"
        TSTZ CreatedAt
    }
    CANDIDATE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 FullName
        VARCHAR2 Email UK
        VARCHAR2 Phone
        TSTZ CreatedAt
    }
    APPLICATION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 RequisitionId FK
        RAW16 CandidateId FK
        VARCHAR2 Stage "APPLIED SCREENING INTERVIEW OFFER HIRED REJECTED WITHDRAWN"
        TSTZ CreatedAt
    }
    INTERVIEW_SCHEDULE {
        RAW16 Id PK
        RAW16 ApplicationId FK
        RAW16 InterviewerEmployeeId "ref HR_CORE.EMPLOYEE"
        TSTZ ScheduledAt
        VARCHAR2 Result "PASS FAIL NO_SHOW"
    }
    OFFER_LETTER {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 ApplicationId FK
        NUMBER OfferedBaseSalary
        CHAR Currency
        DATE StartDate
        VARCHAR2 Status "DRAFT PENDING_APPROVAL APPROVED SENT ACCEPTED DECLINED ON_HOLD WITHDRAWN"
        RAW16 ApprovalRequestId "ref HR_WF"
        TSTZ CreatedAt
    }
    OUTBOX_MESSAGE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 AggregateType
        RAW16 AggregateId
        VARCHAR2 EventType
        JSON Payload
        TSTZ OccurredAt
        TSTZ PublishedAt
    }
    INBOX_MESSAGE {
        RAW16 MessageId PK
        VARCHAR2 Consumer PK
        TSTZ ProcessedAt
    }
```

Ràng buộc: `UQ_APP (RequisitionId, CandidateId)` — một ứng viên nộp một tin đúng một lần; `UX_OFFER_ONE_ACCEPTED` — mỗi application tối đa một offer `ACCEPTED`.

---

## 2.3 Payroll — `HR_PAY` (5 bảng)

```mermaid
erDiagram
    PAYROLL_PERIOD ||--o{ PAYSLIP : issues
    PAYSLIP ||--|{ PAYSLIP_DETAIL : "line items"
    PAYROLL_PERIOD |o--o{ PAYSLIP_DETAIL : "retro for (RetroForPeriodId)"
    SALARY_COMPONENT }o..|| EMPLOYEE : "for (ref HR_CORE)"
    PAYSLIP }o..|| EMPLOYEE : "for (ref HR_CORE)"
    RETRO_TRIGGER }o..|| EMPLOYEE : "recalc for (ref HR_CORE)"
    RETRO_TRIGGER }o..o| CHANGE_SET : "caused by (ref HR_CORE)"

    RETRO_TRIGGER {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId UK "ref HR_CORE; cung SourceRef"
        DATE FromDate "ngay hieu luc som nhat bi anh huong"
        VARCHAR2 Source "SALARY_CHANGE CORE_CHANGE_SET ATTENDANCE_CORRECTION MANUAL"
        VARCHAR2 SourceRef UK "ChangeSetId / EventId"
        TSTZ CreatedAt
        RAW16 ConsumedByCalcRunId "NULL = chua xu ly"
    }
    PAYROLL_PERIOD {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 PeriodCode UK "YYYY-MM"
        DATE StartDate
        DATE EndDate "nua mo"
        NUMBER StandardWorkDays
        VARCHAR2 Status "OPEN CALCULATED LOCKED PAID"
        TSTZ LockedAt "moc phat hien hoi to"
    }
    SALARY_COMPONENT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE.EMPLOYEE"
        VARCHAR2 ComponentType "BASE_SALARY ALLOWANCE_*"
        NUMBER Amount
        CHAR Currency
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
        VARCHAR2 SourceRef "OFFER:id / DECISION:so QD"
        VARCHAR2 RecordedBy
    }
    PAYSLIP {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 PeriodId FK
        RAW16 EmployeeId "ref HR_CORE.EMPLOYEE"
        RAW16 CalcRunId
        NUMBER GrossAmount
        NUMBER NetAmount
        TSTZ CreatedAt
    }
    PAYSLIP_DETAIL {
        RAW16 Id PK
        RAW16 PayslipId FK
        VARCHAR2 LineType "EARNING RETRO_EARNING PIT SOCIAL_INS ..."
        VARCHAR2 ComponentType
        NUMBER Amount "am = khau tru"
        RAW16 RetroForPeriodId FK "NULL = ky hien tai"
        VARCHAR2 Note
    }
    INBOX_MESSAGE {
        RAW16 MessageId PK
        VARCHAR2 Consumer PK
        TSTZ ProcessedAt
    }
```

Ràng buộc: `UQ_PAYSLIP (PeriodId, EmployeeId)`; `TRG_SAL_IMMUTABLE` — chỉ được set `SupersededAt` một lần.
`RETRO_TRIGGER` là **cửa vào duy nhất** cho mọi thay đổi hồi tố (đổi lương, change set CoreHR hồi tố, sửa công)
— 04 §4.6. Payroll không có outbox vì chưa phát event nào ra ngoài.

---

## 2.4 Workflow — `HR_WF` (7 bảng)

```mermaid
erDiagram
    WORKFLOW_TEMPLATE ||--|{ WORKFLOW_STEP_DEF : "defines steps"
    WORKFLOW_TEMPLATE ||--o{ APPROVAL_REQUEST : "instantiated as"
    APPROVAL_REQUEST ||--o{ APPROVAL_TASK : "creates per step"
    APPROVAL_REQUEST ||--|{ APPROVAL_LOG : "audit trail"
    APPROVAL_TASK |o--o{ APPROVAL_LOG : actions
    APPROVAL_REQUEST }o..|| EMPLOYEE : "requester (ref HR_CORE)"
    APPROVAL_TASK }o..|| EMPLOYEE : "assignee (ref HR_CORE)"
    APPROVAL_TASK }o..o| POSITION : "assignee seat (ref HR_CORE)"
    DELEGATION }o..|| EMPLOYEE : "delegator / delegate (ref HR_CORE)"
    WORKFLOW_STEP_DEF }o..o{ AUTHORITY_MATRIX : "rule AUTHORITY_MATRIX tra theo RequestType"

    AUTHORITY_MATRIX {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 RequestType
        CHAR Currency
        NUMBER AmountFrom "nua mo [From, To)"
        NUMBER AmountTo "NULL = khong gioi han"
        NUMBER MinGradeRank "cap toi thieu duoc duyet"
        DATE ValidFrom
        DATE ValidTo
        TSTZ RecordedAt
        TSTZ SupersededAt
    }
    WORKFLOW_TEMPLATE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 RequestType UK "LEAVE OVERTIME ADVANCE REQUISITION OFFER ..."
        NUMBER Version UK
        BOOLEAN IsActive "1 version active / RequestType"
        TSTZ CreatedAt
        VARCHAR2 ResolveAsOf "ACTIVATION_DATE BUSINESS_DATE (V3)"
        VARCHAR2 BusinessDatePath "JSON path ngay nghiep vu (V3)"
    }
    WORKFLOW_STEP_DEF {
        RAW16 Id PK
        RAW16 TemplateId FK
        NUMBER StepNo UK
        VARCHAR2 Name
        VARCHAR2 ApproverRule "LINE_MANAGER MATRIX_MANAGER ORG_HEAD ROLE SPECIFIC_POSITION AUTHORITY_MATRIX"
        VARCHAR2 RuleParam "levelsUp minGrade role startFrom lineType"
        JSON ConditionExpr
        VARCHAR2 ApprovalMode "ANY ALL"
        NUMBER SlaHours
        VARCHAR2 OnTimeout "REMIND ESCALATE AUTO_REJECT"
    }
    APPROVAL_REQUEST {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 TemplateId FK
        VARCHAR2 RequestType
        VARCHAR2 SourceService
        RAW16 SourceRefId "vd OfferId, LeaveRequestId"
        RAW16 RequesterEmployeeId "ref HR_CORE"
        JSON Payload "snapshot cho dieu kien"
        VARCHAR2 Status "SUBMITTED IN_PROGRESS RETURNED APPROVED REJECTED CANCELLED"
        NUMBER CurrentStepNo
        VARCHAR2 IdempotencyKey UK
        NUMBER RowVersion "optimistic lock"
        TSTZ SubmittedAt
        TSTZ CompletedAt
    }
    APPROVAL_TASK {
        RAW16 Id PK
        RAW16 RequestId FK
        NUMBER StepNo
        RAW16 AssigneePositionId "ref HR_CORE, snapshot"
        RAW16 AssigneeEmployeeId "ref HR_CORE"
        RAW16 OnBehalfOfEmployeeId "uy quyen"
        VARCHAR2 Status "PENDING APPROVED REJECTED RETURNED ESCALATED SKIPPED CANCELLED"
        TSTZ DueAt
        TSTZ ActedAt
        VARCHAR2 Comments
    }
    APPROVAL_LOG {
        RAW16 Id PK
        RAW16 RequestId FK
        RAW16 TaskId FK
        VARCHAR2 Action
        RAW16 ActorEmployeeId "NULL = SYSTEM"
        VARCHAR2 FromStatus
        VARCHAR2 ToStatus
        JSON Detail
        TSTZ OccurredAt
    }
    DELEGATION {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 DelegatorEmployeeId "ref HR_CORE"
        RAW16 DelegateEmployeeId "ref HR_CORE"
        VARCHAR2 RequestType "NULL = moi loai"
        DATE ValidFrom
        DATE ValidTo
        TSTZ CreatedAt
    }
    OUTBOX_MESSAGE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 AggregateType
        RAW16 AggregateId
        VARCHAR2 EventType
        JSON Payload
        TSTZ OccurredAt
        TSTZ PublishedAt
    }
```

Ràng buộc: `UX_TASK_OPEN` — không giao trùng task `PENDING` cho một người trong cùng bước; `TRG_LOG_APPEND_ONLY`.

---

## 2.5 Hợp đồng lao động — mở rộng `HR_CORE` (logic)

Hợp đồng nằm cùng CoreHR và gắn với `EMPLOYMENT` (một pháp nhân), không gắn trực tiếp `EMPLOYEE`: người làm
cho hai pháp nhân trong tập đoàn có hai chuỗi hợp đồng độc lập.

```mermaid
erDiagram
    EMPLOYMENT ||--o{ EMPLOYMENT_CONTRACT : "signed under"
    EMPLOYMENT_CONTRACT ||--o{ CONTRACT_AMENDMENT : "amended by"
    EMPLOYMENT_CONTRACT |o--o| EMPLOYMENT_CONTRACT : "renews"

    EMPLOYMENT_CONTRACT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmploymentId FK "quan he lao dong voi 1 phap nhan"
        VARCHAR2 ContractNo UK
        VARCHAR2 ContractType "PROBATION FIXED_TERM INDEFINITE SEASONAL"
        DATE ValidFrom
        DATE ValidTo "NULL = khong xac dinh thoi han"
        RAW16 PreviousContractId FK "hop dong truoc khi gia han"
        VARCHAR2 Status "DRAFT SIGNED ACTIVE EXPIRED TERMINATED"
        DATE SignedDate
        VARCHAR2 DocumentRef "file luu tru"
        TSTZ RecordedAt
        TSTZ SupersededAt
    }
    CONTRACT_AMENDMENT {
        RAW16 Id PK
        RAW16 ContractId FK
        VARCHAR2 AmendmentNo
        DATE EffectiveDate
        VARCHAR2 Summary
        VARCHAR2 DocumentRef
        TSTZ RecordedAt
    }
```

---

## 2.6 Time & Attendance — `HR_TA` (logic)

```mermaid
erDiagram
    SHIFT ||--o{ SHIFT_ASSIGNMENT : "assigned as"
    LEAVE_TYPE ||--o{ LEAVE_BALANCE : "tracked in"
    LEAVE_TYPE ||--o{ LEAVE_REQUEST : "requested as"
    HOLIDAY_CALENDAR ||--|{ HOLIDAY_DATE : contains
    SHIFT_ASSIGNMENT }o..|| EMPLOYEE : "for (ref HR_CORE)"
    ATTENDANCE_RECORD }o..|| EMPLOYEE : "for (ref HR_CORE)"
    LEAVE_BALANCE }o..|| EMPLOYEE : "for (ref HR_CORE)"
    LEAVE_REQUEST }o..|| EMPLOYEE : "filed by (ref HR_CORE)"
    OVERTIME_REQUEST }o..|| EMPLOYEE : "filed by (ref HR_CORE)"
    LEAVE_REQUEST |o..o| APPROVAL_REQUEST : "approved by (ref HR_WF)"
    OVERTIME_REQUEST |o..o| APPROVAL_REQUEST : "approved by (ref HR_WF)"

    SHIFT {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Code UK
        VARCHAR2 Name
        VARCHAR2 StartTime "HH:MI"
        VARCHAR2 EndTime "qua dem neu < StartTime"
        NUMBER BreakMinutes
        NUMBER StandardHours
    }
    SHIFT_ASSIGNMENT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        RAW16 ShiftId FK
        DATE ValidFrom
        DATE ValidTo
    }
    ATTENDANCE_RECORD {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        DATE WorkDate UK "cung EmployeeId"
        TSTZ CheckIn
        TSTZ CheckOut
        VARCHAR2 Source "DEVICE MOBILE MANUAL"
        NUMBER LateMinutes
        NUMBER EarlyLeaveMinutes
        NUMBER WorkedHours
        VARCHAR2 Status "PRESENT ABSENT LEAVE HOLIDAY"
    }
    LEAVE_TYPE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Code UK "ANNUAL SICK MATERNITY UNPAID ..."
        VARCHAR2 Name
        BOOLEAN IsPaid
        NUMBER DefaultDaysPerYear
        NUMBER MaxCarryOverDays
    }
    LEAVE_BALANCE {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        RAW16 LeaveTypeId FK
        NUMBER Year UK "cung EmployeeId, LeaveTypeId"
        NUMBER Entitled
        NUMBER CarriedOver
        NUMBER Used
        NUMBER Pending "dang cho duyet"
    }
    LEAVE_REQUEST {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        RAW16 LeaveTypeId FK
        DATE FromDate
        DATE ToDate
        NUMBER Days "tru ngay le va cuoi tuan"
        VARCHAR2 Reason
        VARCHAR2 Status "DRAFT PENDING APPROVED REJECTED CANCELLED"
        RAW16 ApprovalRequestId "ref HR_WF"
        TSTZ CreatedAt
    }
    OVERTIME_REQUEST {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        DATE WorkDate
        NUMBER Hours
        VARCHAR2 OtType "WEEKDAY WEEKEND HOLIDAY NIGHT"
        VARCHAR2 Status
        RAW16 ApprovalRequestId "ref HR_WF"
    }
    HOLIDAY_CALENDAR {
        RAW16 Id PK
        RAW16 TenantId
        NUMBER Year UK
        VARCHAR2 Name
    }
    HOLIDAY_DATE {
        RAW16 Id PK
        RAW16 CalendarId FK
        DATE HolidayDate UK
        VARCHAR2 Name
        NUMBER OtMultiplier "he so OT ngay le"
    }
```

Chấm công gắn với **nhân viên**, không gắn với `HOLIDAY_CALENDAR`. Ngày lễ được tra theo `WorkDate` khi tính công.
Hệ quả là v1 vẽ sai quan hệ `HOLIDAY_CALENDAR → ATTENDANCE_RECORD`.

---

## 2.7 Talent — `HR_TAL` (logic: Performance, L&D, Succession)

```mermaid
erDiagram
    REVIEW_CYCLE ||--o{ GOAL : scopes
    REVIEW_CYCLE ||--o{ PERFORMANCE_REVIEW : scopes
    REVIEW_CYCLE ||--o{ NINE_BOX_ASSESSMENT : scopes
    GOAL |o--o{ GOAL : "cascades to"
    GOAL ||--o{ KEY_RESULT : "measured by"
    COURSE ||--o{ CLASS_SESSION : runs
    CLASS_SESSION ||--o{ ENROLLMENT : registers
    ENROLLMENT ||--o| CERTIFICATE : "may award"
    SUCCESSION_PLAN ||--o{ SUCCESSION_CANDIDATE : nominates
    GOAL }o..|| EMPLOYEE : "owner (ref HR_CORE)"
    PERFORMANCE_REVIEW }o..|| EMPLOYEE : "reviewee (ref HR_CORE)"
    NINE_BOX_ASSESSMENT }o..|| EMPLOYEE : "assessed (ref HR_CORE)"
    ENROLLMENT }o..|| EMPLOYEE : "learner (ref HR_CORE)"
    SUCCESSION_PLAN }o..|| POSITION : "target seat (ref HR_CORE)"
    SUCCESSION_CANDIDATE }o..|| EMPLOYEE : "nominee (ref HR_CORE)"

    REVIEW_CYCLE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Code UK "2026-H1"
        DATE StartDate
        DATE EndDate
        VARCHAR2 Status "PLANNING GOAL_SETTING REVIEWING CALIBRATING CLOSED"
    }
    GOAL {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 CycleId FK
        RAW16 OwnerEmployeeId "ref HR_CORE"
        RAW16 ParentGoalId FK "OKR cascade"
        VARCHAR2 GoalType "KPI OKR"
        VARCHAR2 Title
        NUMBER Weight "tong = 100 / nguoi / ky"
        VARCHAR2 Status
    }
    KEY_RESULT {
        RAW16 Id PK
        RAW16 GoalId FK
        VARCHAR2 Metric
        NUMBER TargetValue
        NUMBER ActualValue
        VARCHAR2 Unit
    }
    PERFORMANCE_REVIEW {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 CycleId FK
        RAW16 RevieweeEmployeeId UK "cung CycleId"
        RAW16 ReviewerEmployeeId "ref HR_CORE"
        NUMBER SelfScore
        NUMBER ManagerScore
        NUMBER CalibratedScore
        VARCHAR2 Status "SELF MANAGER CALIBRATED FINAL"
    }
    NINE_BOX_ASSESSMENT {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 CycleId FK
        RAW16 EmployeeId UK "ref HR_CORE; cung CycleId"
        NUMBER PerformanceLevel "1..3"
        NUMBER PotentialLevel "1..3"
        VARCHAR2 Box "vd HIGH_PERF_HIGH_POT"
        RAW16 AssessedBy
    }
    COURSE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Code UK
        VARCHAR2 Title
        VARCHAR2 Category
        NUMBER DurationHours
        BOOLEAN IsMandatory
    }
    CLASS_SESSION {
        RAW16 Id PK
        RAW16 CourseId FK
        TSTZ StartAt
        TSTZ EndAt
        VARCHAR2 Location
        NUMBER Capacity
    }
    ENROLLMENT {
        RAW16 Id PK
        RAW16 SessionId FK
        RAW16 EmployeeId UK "ref HR_CORE; cung SessionId"
        VARCHAR2 Status "REGISTERED ATTENDED PASSED FAILED NO_SHOW"
        NUMBER Score
    }
    CERTIFICATE {
        RAW16 Id PK
        RAW16 EnrollmentId FK, UK
        VARCHAR2 CertificateNo UK
        DATE IssuedDate
        DATE ExpiryDate
    }
    SUCCESSION_PLAN {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 PositionId UK "ref HR_CORE; ghe then chot"
        VARCHAR2 RiskOfLoss "LOW MEDIUM HIGH"
        DATE ReviewedDate
    }
    SUCCESSION_CANDIDATE {
        RAW16 Id PK
        RAW16 PlanId FK
        RAW16 EmployeeId UK "ref HR_CORE; cung PlanId"
        VARCHAR2 Readiness "READY_NOW READY_1Y READY_2Y"
        NUMBER Rank
    }
```

---

## 2.8 Offboarding & Asset — `HR_OFF` (logic)

```mermaid
erDiagram
    ASSET_INVENTORY ||--o{ ASSET_ASSIGNMENT : "checked out"
    RESIGNATION_REQUEST ||--|{ HANDOVER_TASK : requires
    ASSET_ASSIGNMENT |o--o{ HANDOVER_TASK : "returned via"
    ASSET_ASSIGNMENT }o..|| EMPLOYEE : "held by (ref HR_CORE)"
    RESIGNATION_REQUEST }o..|| EMPLOYEE : "filed by (ref HR_CORE)"
    HANDOVER_TASK }o..o| EMPLOYEE : "receiver (ref HR_CORE)"
    RESIGNATION_REQUEST |o..o| APPROVAL_REQUEST : "approved by (ref HR_WF)"

    ASSET_INVENTORY {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 AssetTag UK
        VARCHAR2 Category "LAPTOP PHONE CARD ..."
        VARCHAR2 SerialNo
        VARCHAR2 Status "IN_STOCK ASSIGNED REPAIR RETIRED"
    }
    ASSET_ASSIGNMENT {
        RAW16 Id PK
        RAW16 AssetId FK
        RAW16 EmployeeId "ref HR_CORE"
        DATE ValidFrom
        DATE ValidTo "NULL = dang giu"
        VARCHAR2 ReturnCondition
    }
    RESIGNATION_REQUEST {
        RAW16 Id PK
        RAW16 TenantId
        RAW16 EmployeeId "ref HR_CORE"
        DATE SubmittedDate
        DATE LastWorkingDay
        VARCHAR2 ReasonCode
        VARCHAR2 Status "PENDING APPROVED WITHDRAWN COMPLETED"
        RAW16 ApprovalRequestId "ref HR_WF"
    }
    HANDOVER_TASK {
        RAW16 Id PK
        RAW16 ResignationId FK
        VARCHAR2 TaskType "ASSET_RETURN KNOWLEDGE ACCOUNT_REVOKE FINAL_PAY"
        RAW16 AssetAssignmentId FK
        RAW16 ReceiverEmployeeId "ref HR_CORE"
        VARCHAR2 Status "OPEN DONE WAIVED"
        TSTZ CompletedAt
    }
```

Khi `RESIGNATION_REQUEST` được duyệt, Offboarding phát event để CoreHR lập change set `PERSONNEL` với op
`TERMINATE` (hiệu lực = `LastWorkingDay` + 1). Việc đóng `EMPLOYMENT` / `ASSIGNMENT` là quyền của CoreHR,
Offboarding không tự đóng.

---

## 2.9 Identity & RBAC — `HR_IAM` (logic)

```mermaid
erDiagram
    APP_USER ||--o{ USER_ROLE : has
    APP_ROLE ||--o{ USER_ROLE : "granted as"
    APP_ROLE ||--o{ ROLE_PERMISSION : includes
    USER_ROLE ||--o{ ROLE_SCOPE : "limited to"
    APP_USER |o..o| EMPLOYEE : "is (ref HR_CORE)"
    ROLE_SCOPE }o..o| ORG_UNIT : "subtree (ref HR_CORE)"

    APP_USER {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Username UK
        RAW16 EmployeeId UK "ref HR_CORE; NULL = tai khoan he thong"
        VARCHAR2 Status "ACTIVE LOCKED DISABLED"
        TSTZ LastLoginAt
    }
    APP_ROLE {
        RAW16 Id PK
        RAW16 TenantId
        VARCHAR2 Code UK "HRBP C_AND_B FINANCE HR_ADMIN HR_PII_READER"
        VARCHAR2 Name
    }
    ROLE_PERMISSION {
        RAW16 RoleId PK, FK
        VARCHAR2 Permission PK "vd payroll.read, employee.pii.read"
    }
    USER_ROLE {
        RAW16 Id PK
        RAW16 UserId FK
        RAW16 RoleId FK
        DATE ValidFrom
        DATE ValidTo
    }
    ROLE_SCOPE {
        RAW16 Id PK
        RAW16 UserRoleId FK
        RAW16 OrgUnitId "ref HR_CORE; ap dung ca cay con theo Lineage"
    }
```

`ROLE_SCOPE` là nguồn cho quy tắc `ROLE` của Workflow. Ví dụ, "HRBP phụ trách đơn vị của người nộp" là HRBP có
scope là một tổ tiên (theo `Lineage`) của đơn vị người nộp.

---

## 2.10 Nhật ký thay đổi so với v1

| Quan hệ / thực thể | v1 | v2 | Lý do |
|---|---|---|---|
| `ORG_UNIT.ManagerPositionId` | FK vòng sang `POSITION` | bỏ, thay bằng `POSITION.IsOrgHead` | Một nguồn sự thật, không có FK vòng |
| `JOB_REQUISITION` → `CANDIDATE` | `||--o{` | thêm bảng trung gian `APPLICATION` | Một ứng viên nộp nhiều tin |
| `CANDIDATE` → `OFFER_LETTER` | `||--||` | qua `APPLICATION`, `o{` | Đàm phán lại nhiều lần |
| `OFFER_LETTER` → `EMPLOYEE` | `||--||` | `|o..o|` qua event | Không phải offer nào cũng thành nhân viên; khác service |
| `ENROLLMENT` → `CERTIFICATE` | `||--||` | `||--o|` | Trượt thì không có chứng chỉ |
| `EMPLOYEE` → `RESIGNATION_REQUEST` | `||--||` | `o{` | Nghỉ, được tuyển lại, rồi nghỉ tiếp |
| `EMPLOYEE` → `NINE_BOX_GRID` | `||--||` | `NINE_BOX_ASSESSMENT` theo `REVIEW_CYCLE` | Đánh giá theo từng kỳ |
| `HOLIDAY_CALENDAR` → `ATTENDANCE_RECORD` | FK | bỏ | Chấm công thuộc về người; ngày lễ tra theo ngày |
| `EMPLOYEE` → `SALARY_COMPONENT` / `PAYSLIP` | FK | nét đứt | Khác service |
| `PAYROLL_PERIOD`, `RetroForPeriodId` | không có | thêm | Điều kiện cần cho lương hồi tố |
| Performance (KPI/OKR), Identity | không có thực thể | `REVIEW_CYCLE`, `GOAL`, `KEY_RESULT`, `PERFORMANCE_REVIEW`, `APP_USER`, `APP_ROLE`… | v1 liệt kê BC nhưng không có bảng nào |
| Cột trên sơ đồ | chỉ 4 bảng có cột | mọi bảng có đủ cột | ERD phải đọc được độc lập với SQL |

**v3 — cơ cấu tổ chức vận hành được (27/09/2026)**

| Thay đổi | v2 | v3 | Lý do |
|---|---|---|---|
| Đơn vị, ghế | 1 bảng trạng thái hiện tại | định danh + phiên bản bitemporal (`*_VERSION`) | Xem cơ cấu tại ngày bất kỳ, hẹn ngày, hồi tố |
| Cây tổ chức | `ORG_UNIT.ParentId` + `Lineage` | `ORG_EDGE` theo thời gian, 3 loại cây; `Lineage` chỉ còn ở cache `ORG_PATH_CURRENT` | Lineage không thể theo thời gian rẻ; nhiều loại phân cấp song song |
| Chuỗi báo cáo | `POSITION.ReportsToPositionId` nhập tay | suy ra từ `ORG_UNIT_HEAD` + `ORG_EDGE` (INHERIT), override EXPLICIT, `POSITION_MATRIX_LINE` | Di chuyển đơn vị thì chuỗi duyệt tự đi theo; có báo cáo ma trận |
| Trưởng đơn vị | `POSITION.IsOrgHead` | `ORG_UNIT_HEAD` theo thời gian | Đổi trưởng có ngày hiệu lực |
| Người – ghế | `EMPLOYMENT_RECORD` | `EMPLOYMENT` (+ `_VERSION`, theo pháp nhân) + `ASSIGNMENT` (chính / kiêm nhiệm / quyền / biệt phái, FTE) | Nhiều pháp nhân, tuyển lại, thâm niên, quyền trưởng |
| Định biên | `HeadcountPlan` (số người), ghế quản lý = 1 | `FteBudget` theo thời gian, kiểm theo khoảng | Bán thời gian, chia sẻ ghế, bàn giao chồng lấn có duyệt |
| Ghi thay đổi | package ghi từng thao tác | `CHANGE_SET` / `CHANGE_ITEM` + Change Engine + `PKG_INTEGRITY` | Quyết định áp nguyên khối, truy vết, sửa sai, đảo |
| Hồi tố lương | chỉ quét `SALARY_COMPONENT` | `RETRO_TRIGGER` gom mọi nguồn | Điều chuyển / thăng chức / sửa công hồi tố cũng làm sai lương |
| Hạn mức duyệt | điều kiện rải trong template | `AUTHORITY_MATRIX` theo thời gian | Đổi chính sách không phải sửa template |
