HR (Kadry i płace)
Podkatalog HR zawiera model kanoniczny dla domeny kadr i płac, spójny z systemami ERP (SAP HCM / SuccessFactors, Oracle HCM Cloud, Workday). Zasoby są wzorowane na DomainResource i łączą się z Party (pracownik, pracodawca), PartyRole oraz DocumentReference (dokumenty kadrowe).
Zasoby
| Zasób | Opis |
|---|---|
| Employment | Zatrudnienie – kontekst kadrowy relacji employer–employee: employer i employee (Reference do PartyRole); period, position, type, kind, workTime, workTimeText, primaryEmployment |
| Position | Stanowisko – slot organizacyjny z identyfikatorem (przestrzeń Position.Id) i nazwą; zajmowany przez Employment. Stanowisko nie jest powiązane z komórką organizacyjną ani ze stanowiskiem nadrzędnym. |
| OrganizationUnit | Jednostka organizacyjna – komórka, dział, oddział: identifier, name, symbol, shortName, partOf, organization (1..1 – firma), address, period. Kierownik/zastępca = OrganizationAssignment z hierarchyLevel, hierarchyIndex, hierarchyLabel |
| OrganizationAssignment | Przypisanie do jednostki organizacyjnej – employee (PartyRole), organizationalUnit (Reference OrganizationUnit), period, hierarchyLevel, hierarchyIndex, hierarchyLabel, employment, primaryEmployment |
| Qualification | Kwalifikacja zawodowa – holder (PartyRole), type (prawo wykonywania zawodu, specjalizacja), number, issuedDate, validityPeriod |
| ProfessionalGroup | Grupa zawodowa – identifier, name, shortName, symbol, partOf, organization (firma), status; hierarchia grup |
| EmployeeProfessionalGroup | Przypisanie pracownika do grupy zawodowej – employee, professionalGroup, employment, primaryEmployment, period |
| AttendanceCredential | Karta RCP – employee (PartyRole), identifier (id, numer karty ID_RCP, kod kreskowy), technology, role (primary/secondary), status, validPeriod |
| AttendanceTerminal | Rejestrator czasu pracy – identifier (id KS-ZZL, id u vendora), name, capability, status |
| AttendanceRecord | Atomowe zdarzenie czasu pracy – eventDate, type, terminal, employee / credential, status (accepted, rejected, duplicate) |
Przykłady integracji RCP: Time & Attendance (RCP) – przykłady.
Operacje
Zasoby HR zwracają kopertę { "items": [...], "nextToken": null } z paginacją count/offset. Parametr identifier to zawsze jedna para system|wartość. Wszystkie są tylko do odczytu (GET) poza zasobami RCP: AttendanceCredential (POST, PATCH), AttendanceTerminal i AttendanceRecord (POST). Zapis przyjmuje jeden obiekt i zwraca { "items": [ <zasób> ] }.
| Zasób | Ścieżka | Parametry (poza identifier, count, offset) |
|---|---|---|
| Employment | GET /v1/employments |
kind (system\|kod), employeeId |
| Position | GET /v1/positions |
— |
| OrganizationUnit | GET /v1/organization-units |
— |
| OrganizationAssignment | GET /v1/organization-assignments |
employeeId, organizationUnitId |
| Qualification | GET /v1/qualifications |
type (wymagany, system\|kod), holder (PartyRole\|wartość), number |
| ProfessionalGroup | GET /v1/professional-groups |
— |
| EmployeeProfessionalGroup | GET /v1/employee-professional-groups |
— |
| AttendanceCredential | GET, POST, PATCH /v1/attendance-credentials |
employee (przestrzeń PartyRole.Id), status, role (system\|kod) |
| AttendanceTerminal | GET, POST /v1/attendance-terminals |
status (system\|kod) |
| AttendanceRecord | GET, POST /v1/attendance-records |
employee (przestrzeń PartyRole.Id albo PartyRole\|wartość), terminal (przestrzeń AttendanceTerminal.Id), type (system\|kod) |
Relacje
- Employment wskazuje employer i employee (Reference PartyRole); period, position (Position), type/kind (umowa).
- Position – Employment.position wskazuje na Position; model nie ma hierarchii stanowisk.
- OrganizationUnit – hierarchia przez partOf (OrganizationUnit → OrganizationUnit). Kierownik jednostki = OrganizationAssignment z hierarchyLevel.
- OrganizationAssignment – employee (PartyRole), organizationalUnit (Reference OrganizationUnit), period, hierarchyLevel, hierarchyIndex, hierarchyLabel; opcjonalnie employment, primaryEmployment (Reference Employment). Pion, dział, komórka = typy OrganizationUnit.
- Qualification – holder (PartyRole), type, number, validityPeriod; rejestr kwalifikacji zawodowych (prawo wykonywania zawodu, specjalizacja).
- ProfessionalGroup – hierarchia grup zawodowych z organization. EmployeeProfessionalGroup – przypisanie pracownika do grupy z period, employment.
- Capability – definicja pojedynczej zdolności (identifier, name, type/category). → Core Capability
- GrantAssignment – przypisanie uprawnień: assignedTo (komu – Party, PartyRole, Position lub OrganizationUnit; PartyRole dla przypisania do osoby w roli), scope (względem kogo/czego – kontekst organizacyjny), granted (lista referencji do Duty i/lub Capability – co nadane), period, basis (np. appointment, delegation), basedOn (np. Reference Document, Employment). → Core GrantAssignment
Dokumenty kadrowe (szkolenia, umowy) – DocumentReference; valueReference do Employment.