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 |
Operacje
Wszystkie zasoby HR są tylko do odczytu (GET) i zwracają kopertę { "items": [...], "nextToken": null } z paginacją count/offset. Parametr identifier to zawsze jedna para system|wartość.
| 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 |
— |
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.