Skip to content

Permissions & Settings Reference ​

This reference outlines the role-based permission matrix governing NKL-HR HRMS modules and system administration tasks.

Full Settings Guide: For the complete, detailed administrator manual covering all sections, navigation paths, and master data import workflows, see the Settings Admin Guide.


1. Role-Based Permissions Reference ​

Roles & Permission Groups

Permissions are configured per ministry under Settings › General › Roles and Permissions. Assigning permissions through standardized roles ensures consistent security across departments.

Menu Access Restrictions

ModuleAdministrative CapabilitySystem Permission Name
EmployeeView all employee records in directoryView Employee
Create new employee recordsAdd Employee
Edit, import, archive, bulk mail, reset passwords, inviteChange Employee
Export employee directory data to spreadsheetExport access for employees
Publish, edit, and delete company policiesAdd Policy, Change Policy, Delete Policy, View Policy
Record and manage formal disciplinary actionsAdd Disciplinary Action, Change Disciplinary Action, Delete Disciplinary Action
Access configuration lists (shifts, schedules, work types)View Employee Shift, View Work Type, View Employee Tag, etc.
AttendanceView organization-wide attendance & monthly summaryView Attendance
Create, edit, and import attendance recordsAdd Attendance, Change Attendance
Delete attendance entriesDelete Attendance
Validate daily attendance and approve overtime hoursChange Attendance
Access late arrival and early departure trackingView Attendance Late Come Early Out
Manage time policies and validation conditionsView Attendance Validation Condition, Add Attendance Validation Condition, Change Attendance Validation Condition
Modify attendance rules and clock-in preferencesChange Attendance General Setting
Configure IP login restrictionsAdd Attendance
LeaveAccess leave dashboard and review all employee requestsView Leave Request
Create, approve, reject, or delete leave requests for othersAdd Leave Request, Change Leave Request, Delete Leave Request
Assign, edit, and view employee leave balance ledgersView Available Leave, Add Available Leave, Change Available Leave
Create and manage leave typesAdd Leave Type, Change Leave Type, Delete Leave Type
Configure restricted blackout periodsView Restrict Leave, Add Restrict Leave, Change Restrict Leave, Delete Restrict Leave
Modify global leave rulesAdd Restrict Leave
Process employee leave allocation requestsView Leave Allocation Request, Change Leave Allocation Request
OnboardingView hired candidate directoryView Onboarding Candidate, View Candidate
Access onboarding tasks and stage pipelinesView Onboarding Stage, View Recruitment (or designated Stage Manager)
Create new onboarding stages and manage stage orderAdd Onboarding Stage (or designated Pipeline Manager)
Edit or delete existing onboarding stagesChange Onboarding Stage, Delete Onboarding Stage
Advance candidates across onboarding stagesChange Candidate Stage (or designated Stage Manager)
Create, edit, and delete stage checklist tasksAdd Onboarding Task, Change Onboarding Task, Delete Onboarding Task
Update candidate task completion statusesChange Candidate Task (or designated Task Manager)
Create and update candidate profilesAdd Candidate, Change Candidate
OffboardingView offboarding dashboard and pipeline metricsView Offboarding
Create, edit, and delete exit processesAdd Offboarding, Change Offboarding, Delete Offboarding
Manage exit process stagesAdd Offboarding Stage, Change Offboarding Stage, Delete Offboarding Stage
Advance departing employees across exit stagesChange Offboarding (or designated Stage Manager)
Create, edit, and delete exit checklist tasksAdd Offboarding Task, Change Offboarding Task, Delete Offboarding Task
Review employee resignation lettersView Resignation Letter
Approve, reject, or decide resignation cancellationsChange Resignation Letter
Modify offboarding rules and default notice periodChange Offboarding General Setting
E-LearningView course listings and open the course builderView Course
Create, edit, publish, and delete courses and quizzesAdd Course, Change Course, Delete Course
Create training assignments for employees or groupsAssign Course
Inspect and delete training assignmentsView Course Assignment, Delete Course Assignment
Monitor learner enrolments and remove enrolmentsView Enrollment, Delete Enrollment
Download learner completion certificates across ministryView Certificate
Manage course categories and certificate templatesView Course Category, Add Course Category, Change Course Category, Delete Course Category, View Certificate Template, etc.
Access course lesson filesView Lesson
PensionApprove pension files and claim liquidationsCan approve pension files (plus specialized role groups: Liquidator, Financial Controller, Director of Pensions, Pension Payroll Officer, Parameter Administrator)

Note on Employee Self-Service: Core self-service views (My Attendances, My Leave Requests, My Learning, Course Catalog, My Certificates) require no specialized administrative permissions.


2. Settings Items Permissions ​

Settings ItemRequired Access Permission
System PreferencesView Company, Change Employee General Setting, or View History Tracking Fields
Menu Access RestrictionsView Permission
Roles and PermissionsSuperusers only
Audit & HistoryView Audit Tag or View Audit Model Config
Outlook MailView Dynamic Email Configuration (when Outlook add-on is active)
Companies / Departments / Positions / RolesView Company / View Department / View Job Position / View Job Role
Weekly Off DaysView Company Leaves
Email ServersView Dynamic Email Configuration (when Outlook add-on is inactive)
Email TemplatesView Mail Template
Email AutomationsView Mail Automation
Candidate PortalView Recruitment
Attendance RulesPermissions for attendance, biometric, geofencing, or face detection settings
Leave RulesAdd Restrict Leave or View Attendance Validation Condition
Encashment SettingsChange Encashment General Settings
Offboarding RulesChange Offboarding General Setting or Change Payroll General Setting
Asset RuleView Asset General Setting / Change Asset General Setting
Course Categories / Certificate TemplatesView Course Category / View Certificate Template
Color ThemeView Color Theme
Integrations (Drive, LinkedIn, LDAP, Meet, WhatsApp)Designated integration permissions per service
Import Data / Import HistorySuperuser, or Add Employee, Add Available Leave, Add Asset, Add Asset Assignment
Manage ToursView Tour (when product tours are active)

3. System Administrator Command-Line Operations ​

These maintenance and setup tasks are executed via the server command line by technical administrators:

CommandOperational Purpose
python manage.py migrateApplies all database schema migrations (including E-Learning and Pension modules).
python manage.py compilemessagesCompiles language translation catalogs.
python manage.py seed_pension_pack carLoads the statutory Central African Republic (CAR) pension pack. Safe to run repeatedly; only provisions missing records without overwriting custom edits.
python manage.py import_pension_data <kind> <file> [--commit] [--skip-errors]Command-line execution of pension data migration batches for members, service periods, contributions, beneficiaries, and active pensions.
python manage.py elearning_resync_progressRecalculates learner progress percentages across active enrolments.
python manage.py seed_elearning_demoLoads sample e-learning demonstration courses, categories, and quizzes (--reset to rebuild or --remove to purge).