Skip to main content

A functional overview of the Employee Management module for administrators and system users.

A functional overview of the Employee Management module for administrators and system users.

1. System Overview

The Employee Microservice is the central platform for managing the workforce records of schools and government
departments (Directorate of Higher Education — DHE) on the Samarth platform. It keeps a single, authoritative record of
every employee — teaching, non-teaching, vocational, and departmental — along with their personal, contact, address,
qualification, employment, document, and organisation-association details.
The system supports administrative day-to-day work such as onboarding new employees, transferring them between
organisations, tracking deputations, approving employee-requested profile updates, publishing dashboards, and
generating reports. It is multi-tenant: each state or organisation operates on its own isolated dataset identified by a
tenant name.


2. User Roles

Role

Description

schoolADMIN

School administrator. Full access within their own school.

dhe

Directorate of Higher Education administrator. Broad access across the department scope.

dheEmployee

Departmental employee. Access depends on their designation, department scope, and explicitly granted permissions.

employee

Regular school employee. Self-service by default; wider access only with explicit grants.

student

Very limited access (used only by a single functionalaccess endpoint).

Service (internal)

Other Samarth microservices calling this service through a service key or API key.

Individual users can also carry explicit permission codes granted at the account level, which unlock capabilities beyond the role default (for example, listing employees, exporting, or updating other employees' records).


 

3. Major Features Overview

S.No.

Feature

What It Provides

1

Employee Management

End-to-end management of employee records — personal info, contacts, addresses, qualifications, employment history, professional (teaching/nonteaching/vocational) details, and profile updates.

2

Bulk Employee Onboarding

Onboard many employees at once from a spreadsheet, with downloadable templates and validation reports.

3

Employee Document Management

Upload, view, replace, download, and remove supporting documents (Aadhaar, PAN, orders, and other attachments) for each employee.

4

Profile Update Approval Workflow

Employees can propose changes to their own profile; administrators review, approve, or reject them; employees acknowledge the outcome.

5

Organisation Association

Management

Manage each employee's primary school, secondary school associations (deputation / additional charge), department affiliations, and bulk organisation switches, with a full history trail.

6

Employee Dashboards & Analytics

Live statistics and breakdowns of the workforce — totals, active/inactive splits, gender, social category, deputation, top designations, and geographical distribution.

7

Employee Export Reports

Download the workforce list (all or filtered) as an Excel file, scoped to the user's access.

8

Designation Catalogue

Management

Maintain the master list of designations at state, school, and department scopes, including subdesignations and department-specific specified designations.

9

Organisation Admin Mapping

Mark specific employees as administrators for a school or organisation so downstream permission checks recognise them.

10

Access Control & Permission

Insights

List employees who hold permissions in a given school and view the detailed permission set of a specific employee.

11

Multi-tenant, Role-based Access

Every request is scoped to a tenant, an authenticated user, and their role/permissions, with strict fail-closed rules for out-of-scope requests.