JobPosition
Represents the definition of a job role, function, or position within an organization - not the person holding it, but the formal position specification itself. JobPosition serves as the universal template that defines what a job is across all industries and organizational contexts. From corporate environments (Software Engineer, Marketing Director, Chief Financial Officer) to healthcare facilities (Registered Nurse, Emergency Physician, Medical Technologist), government agencies (Program Analyst, Public Works Supervisor, City Manager), logistics operations (Fleet Dispatcher, Warehouse Manager, Delivery Driver), retail businesses (Store Associate, Department Manager, Regional Director), educational institutions (Teacher, Principal, Counselor), and manufacturing plants (Production Supervisor, Quality Control Inspector, Plant Engineer). Each JobPosition defines the core attributes that make a position recognizable and consistent: its official title, unique position code, hierarchical level within the organization, department assignment, employment type compatibility, and current status. This entity enables organizations to standardize job definitions, manage organizational hierarchies, support workforce planning, ensure consistent job classifications, facilitate career progression mapping, and maintain position lifecycles from creation through deprecation. JobPosition integrates with Employee (who holds the position), Organization (who defines it), and Department (where it exists). The entity supports positions at any organizational level from entry-level individual contributors through C-suite executives, accommodates both departmental and organization-wide roles, and handles various employment arrangements. This separation between position definition and position holder enables multiple employees to share the same position specification while maintaining individual employment records, supports historical tracking of organizational structure evolution, and provides a foundation for competency frameworks, compensation structures, and talent management systems across any industry or organizational model.
Properties
| Property | Type | Mode | Description | Required |
|---|---|---|---|---|
| title | string | stored | Official title or name of the position Example: | Required |
| code | string | stored | Unique identifier or code for the position used in systems and job classifications Example: | Required |
| description | string | stored | Detailed description of the position's purpose, responsibilities, and key functions | Optional |
| organization | Organization | stored | Reference to the Organization that defines and owns this position | Required |
| department | Department | stored | Reference to the Department where this position exists (null for organization-wide positions not tied to a specific department) | Optional |
| level | string | stored | Hierarchical level or grade of the position within the organizational structure Values: Example: | Required |
| status | string | stored | Current status indicating whether this position is actively used, temporarily inactive, or permanently deprecated Values: Example: | Required |
| employmentTypes | string[] | stored | Types of employment arrangements compatible with this position (which employment types can hold this position) Example: | Required |
| shortTitle | string | stored | Abbreviated or shortened version of the position title Example: | Optional |
| reportsTo | JobPosition | stored | Reference to the JobPosition that this position reports to in the organizational hierarchy | Optional |
| metadata | json | stored | Additional position-specific data for extensibility - use for salary bands, required skills/qualifications, certifications, experience requirements, headcount, budget allocation, or other domain-specific position details | Optional |
| isActive | boolean | calculated | Whether the position is currently active and available for assignment | Optional |
| isDepartmental | boolean | calculated | Whether this position is assigned to a specific department (true) or is organization-wide (false) | Optional |
| isManagement | boolean | calculated | Whether this position is at management level or above (manager, director, VP, C-level) | Optional |
| isExecutive | boolean | calculated | Whether this position is at executive level (VP or above) | Optional |
| isCLevel | boolean | calculated | Whether this position is at C-level (executive leadership) | Optional |
| allowsFullTime | boolean | calculated | Whether this position supports full-time employment | Optional |
| allowsPartTime | boolean | calculated | Whether this position supports part-time employment | Optional |
| allowsContract | boolean | calculated | Whether this position supports contract employment | Optional |
| hasReportingLine | boolean | calculated | Whether this position has a defined reporting line (reportsTo is set) | Optional |
| currentEmployees | Employee[] | calculated | All active employees currently holding this position | Optional |
| directReports | JobPosition[] | calculated | All positions that report directly to this position (inverse of reportsTo) | Optional |
Examples
Example 1
{
"@type": "JobPosition",
"title": "Senior Software Engineer",
"code": "POS-ENG-SR-001",
"description": "Responsible for designing, developing, and maintaining complex software systems. Provides technical leadership, mentors junior engineers, participates in architecture decisions, and ensures code quality and best practices across the engineering team.",
"organization": {
"@type": "Organization",
"name": "TechCorp Solutions",
"legalName": "TechCorp Solutions Inc."
},
"department": {
"@type": "Department",
"name": "Engineering",
"code": "ENG-001"
},
"level": "senior",
"status": "active",
"employmentTypes": [
"full-time",
"contract"
],
"shortTitle": "Sr. SWE",
"reportsTo": {
"@type": "JobPosition",
"title": "Engineering Manager",
"code": "POS-ENG-MGR-001"
},
"metadata": {
"salaryBand": "E5",
"requiredSkills": [
"Java",
"Python",
"System Design",
"Leadership"
],
"minimumExperience": "5+ years",
"headcount": 12,
"openPositions": 2
}
}Example 2
{
"@type": "JobPosition",
"title": "Registered Nurse - Emergency Department",
"code": "POS-MED-RN-ED-001",
"description": "Provides direct patient care in the emergency department, assessing patient conditions, administering medications and treatments, collaborating with physicians and healthcare teams, maintaining accurate medical records, and ensuring patient safety in high-acuity emergency situations.",
"organization": {
"@type": "Organization",
"name": "City General Hospital",
"legalName": "City General Hospital LLC"
},
"department": {
"@type": "Department",
"name": "Emergency Department",
"code": "MED-ED-001"
},
"level": "intermediate",
"status": "active",
"employmentTypes": [
"full-time",
"part-time",
"contract",
"temporary"
],
"shortTitle": "RN-ED",
"reportsTo": {
"@type": "JobPosition",
"title": "ED Nurse Manager",
"code": "POS-MED-MGR-ED-001"
},
"metadata": {
"requiredCertifications": [
"RN License",
"BLS",
"ACLS",
"PALS"
],
"shiftTypes": [
"day",
"night",
"rotating"
],
"requiredEducation": "BSN or ADN",
"minimumExperience": "2+ years",
"headcount": 45
}
}Example 3
{
"@type": "JobPosition",
"title": "Fleet Operations Supervisor",
"code": "POS-OPS-FLEET-SUP-001",
"description": "Oversees daily fleet operations including vehicle assignments, driver scheduling, route optimization, maintenance coordination, and performance monitoring. Manages team of drivers and dispatchers, ensures compliance with DOT regulations, and maintains operational efficiency across the fleet.",
"organization": {
"@type": "Organization",
"name": "Express Logistics Inc.",
"legalName": "Express Logistics Incorporated"
},
"department": {
"@type": "Department",
"name": "Fleet Operations",
"code": "OPS-FLEET-001"
},
"level": "manager",
"status": "active",
"employmentTypes": [
"full-time"
],
"shortTitle": "Fleet Supervisor",
"reportsTo": {
"@type": "JobPosition",
"title": "Director of Operations",
"code": "POS-OPS-DIR-001"
},
"metadata": {
"requiredCertifications": [
"DOT Compliance Training"
],
"managementScope": "15-20 direct reports",
"minimumExperience": "5+ years in logistics/transportation",
"headcount": 3
}
}Example 4
{
"@type": "JobPosition",
"title": "Store Manager",
"code": "POS-RET-STORE-MGR-001",
"description": "Manages all aspects of retail store operations including sales performance, customer service, inventory management, staff scheduling and development, visual merchandising, loss prevention, and P&L accountability. Drives store revenue and ensures exceptional customer experience.",
"organization": {
"@type": "Organization",
"name": "RetailMart",
"legalName": "RetailMart Corporation"
},
"department": {
"@type": "Department",
"name": "Store Operations - Downtown",
"code": "STORE-DT-001"
},
"level": "manager",
"status": "active",
"employmentTypes": [
"full-time"
],
"shortTitle": "Store Mgr",
"reportsTo": {
"@type": "JobPosition",
"title": "District Manager",
"code": "POS-RET-DIST-MGR-001"
},
"metadata": {
"storeSize": "large",
"averageStaffSize": "25-30 employees",
"requiredExperience": "3+ years retail management",
"headcount": 1
}
}Example 5
{
"@type": "JobPosition",
"title": "Chief Technology Officer",
"code": "POS-EXEC-CTO-001",
"description": "Provides executive leadership for all technology strategy, innovation, and operations. Defines technology vision and roadmap, oversees engineering and IT organizations, drives digital transformation initiatives, manages technology budgets and vendor relationships, and ensures technology capabilities align with business objectives.",
"organization": {
"@type": "Organization",
"name": "TechCorp Solutions",
"legalName": "TechCorp Solutions Inc."
},
"level": "c-level",
"status": "active",
"employmentTypes": [
"full-time"
],
"shortTitle": "CTO",
"reportsTo": {
"@type": "JobPosition",
"title": "Chief Executive Officer",
"code": "POS-EXEC-CEO-001"
},
"metadata": {
"executiveLevel": "C-Suite",
"boardMember": true,
"minimumExperience": "15+ years technology leadership",
"headcount": 1,
"compensationStructure": "executive"
}
}