> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Learning Management (LMS)

> Create courses, assign training, and track employee learning and development

## Overview

The **Learning Management System (LMS)** enables you to create training courses, assign them to employees, and track progress through lessons, quizzes, and certifications. It integrates with the hiring and onboarding flow to ensure new hires complete required training.

## Course Structure

```
Course
├── Module 1: Company Overview
│   ├── Lesson 1.1: Welcome Video
│   ├── Lesson 1.2: Company History
│   └── Quiz 1: Company Knowledge Check
├── Module 2: Safety Training
│   ├── Lesson 2.1: Workplace Safety
│   ├── Lesson 2.2: Emergency Procedures
│   └── Quiz 2: Safety Assessment
└── Certificate: Safety Certification
```

### Courses

A **Course** represents a complete training program:

| Field          | Description                                  |
| -------------- | -------------------------------------------- |
| Title          | Course name                                  |
| Description    | Course overview                              |
| Duration       | Estimated time to complete                   |
| Category       | Training category (compliance, skills, etc.) |
| Prerequisites  | Required courses to complete first           |
| Certificate    | Certificate awarded on completion            |
| Pass Threshold | Minimum score to pass                        |

### Lessons

**Lessons** are individual learning units within a course:

* Video content
* Text/HTML content
* PDF documents
* Interactive exercises
* External links

### Quizzes

**Quizzes** assess understanding after lessons:

| Feature        | Description                                         |
| -------------- | --------------------------------------------------- |
| Question Types | Multiple choice, true/false, short answer           |
| Scoring        | Points per question, weighted scoring               |
| Attempts       | Configurable retry limits                           |
| Passing Score  | Minimum score to pass the quiz                      |
| Time Limit     | Optional time constraint                            |
| Dimensions     | Multi-dimensional scoring (knowledge, skills, etc.) |

### Certificates

**Certificates** are awarded upon course completion:

* Auto-generated with candidate name and completion date
* Customizable certificate templates
* Expiration dates for recurring certification requirements
* Downloadable PDF format

## Enrollments

A **Course Enrollment** tracks an individual's progress through a course:

```mermaid theme={null}
stateDiagram-v2
    [*] --> Enrolled
    Enrolled --> InProgress: First lesson started
    InProgress --> InProgress: Lesson completed
    InProgress --> Completed: All lessons & quizzes passed
    InProgress --> Failed: Quiz score below threshold
    Failed --> InProgress: Retry allowed
    Completed --> Certified: Certificate issued
    Certified --> [*]
```

### Enrollment Data

| Field           | Description                              |
| --------------- | ---------------------------------------- |
| Course          | The training course                      |
| Contract        | The employee/learner                     |
| Status          | Enrolled, in progress, completed, failed |
| Progress        | Percentage of lessons completed          |
| Score           | Overall course score                     |
| Certificate     | Certificate record (if awarded)          |
| Enrollment Date | When the enrollment was created          |
| Completion Date | When the course was finished             |

## Lesson Submissions

Each lesson completion creates a **Lesson Submission**:

* Tracks time spent on the lesson
* Records quiz answers and scores
* Supports multi-dimensional scoring for skills assessment
* Stores question-level attempt data

### Dimension-Based Scoring

For advanced assessments, the LMS supports **scoring dimensions**:

* Knowledge retention
* Practical skills
* Safety awareness
* Communication ability

Each question can contribute to multiple dimensions, providing a nuanced view of the learner's capabilities.

## Integration with Hiring & Onboarding

### Automation Actions

The **Enroll Course** action in automations enables:

| Trigger           | Action                            |
| ----------------- | --------------------------------- |
| Contract created  | Enroll in company orientation     |
| Stage reached     | Assign role-specific training     |
| Document approved | Enroll in certification course    |
| Annual schedule   | Re-enroll for compliance training |

### Onboarding Flows

LMS courses can be incorporated into onboarding flows:

1. New hire contract is created
2. Automation enrolls them in required courses
3. Progress is tracked alongside other onboarding tasks
4. Onboarding completion requires course completion

## Reporting

Track training metrics across your organization:

* Course completion rates
* Average scores by course and department
* Time to completion
* Overdue training assignments
* Certificate expiration tracking