# Statistics Dashboard

> **Portal:** `/lms` · **Desk:** Learning workspace

---

## Overview

The **Training Analytics** page (`/lms/statistics`, **Statistics.vue**) gives L&D and HR administrators visual insight into course catalog size, enrollments, completions, certifications, assessment performance, mandatory training compliance, and learner engagement. Data loads from `get_chart_details` and `get_advanced_statistics` API endpoints.

Use this dashboard for quarterly business reviews alongside HR [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) reports—LMS shows learning activity; HR shows regulatory status. Cross-reference overdue **LMS Training Assignment** rows with compliance **Expired** items for complete workforce picture.

## Accessing the dashboard

1. Log in as **Moderator**, **System Manager**, or user with statistics permission.
2. Navigate `/lms/statistics` from Learning sidebar **Statistics** link.
3. Dashboard auto-loads charts on page mount.

Learners (**LMS Student**) typically do not see this page—role-gated at route level.

## Top-level metric cards

Five **NumberChart** tiles summarize:

| Card | API field | Meaning |
|------|-----------|---------|
| **Courses** | `courses` | Count of published courses |
| **Signups** | `users` | Active employees / LMS users |
| **Enrollments** | `enrollments` | Total **LMS Enrollment** rows |
| **Completions** | `completions` | Enrollments at 100% progress |
| **Certifications** | `certifications` | **LMS Certificate** count |

Hover tooltips clarify definitions. These are point-in-time totals unless otherwise noted on charts.

## Advanced analytics sections

**Training Completion Rate** — single percentage across all enrollments with subtitle "Overall across all training."

**Completion Rate Trend** — bar chart by month showing historical completion rate percentages—spot seasonal drops (e.g., holiday periods).

**Mandatory Training Compliance** — when data available, grid shows:
- Compliance Rate %
- Completed count
- Overdue count
- Total Assigned

Derived from **LMS Training Assignment** statuses and mandatory course enrollments—mirrors HR compliance thinking but LMS-scoped. HR teams still maintain authoritative [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) for non-LMS requirements.

**Average Assessment Scores** — horizontal bar chart per course title with color coding:
- Green ≥ 70%
- Amber ≥ 50%
- Red < 50%

Identifies courses where learners struggle—trigger content or quiz review.

**Top Training by Enrollment** — ranks courses by enrollment volume for capacity planning.

**Employee Engagement** — weekly active employees over last 8 weeks (teal bar chart)—measures portal adoption.

## Time-series charts

Lower section retains classic charts:

- **Employee Signups** — line chart, signups per day
- **Training Enrollments** — enrollments per day
- **Certifications** — certificates issued per day
- **Training Completion** — donut chart enrolled vs completed split

Use date patterns to correlate with HR hiring waves (**Employee** creation triggers LMS student role) and onboarding auto-enroll hooks.

## Using data for HR decisions

| LMS metric | HR action |
|------------|-----------|
| High overdue in Mandatory Compliance | Send reminders; check [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) alignment |
| Low assessment scores | Revise course; consider instructor-led session |
| Low engagement weeks | Promote training in company comms |
| Certification spike | Batch issue [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) filings |

Export underlying data from desk list views for deeper analysis—Statistics page is visual summary, not full BI replacement.

## API details for developers

`lms.lms.api.get_chart_details` — basic counts and chart series for signups, enrollments, certifications, completion donut.

`lms.lms.api.get_advanced_statistics` — returns:
- `completion_rate`
- `completion_trend[]` with month, rate
- `compliance` object with rate, completed, overdue, total
- `assessment_scores[]` with course, avg_score
- `top_courses[]` with course, enrollments
- `weekly_engagement[]` with week, active

Resources cached in frontend with keys `statistics` and `advanced_statistics`—refresh page for latest after bulk enrollments.

## Tips

- Review dashboard weekly during mandatory training rollouts.
- Compare LMS overdue assignments with HR compliance expiry reports monthly.
- Investigate courses with red assessment bars before renewing content.
- Screenshot metrics for leadership slides; link to [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) for regulatory appendix.

## Troubleshooting

| Issue | What to do |
|-------|------------|
| Page empty | Verify API permissions; check browser console |
| Compliance section hidden | No mandatory assignments/enrollments yet |
| Zero assessments | No quiz submissions recorded |
| Stale numbers | Hard refresh; clear site cache |
| Access denied | User lacks Moderator/System Manager role |

---

## Frequently asked questions

### Does LMS training completion automatically update Employee Compliance?

No. Smooth LMS tracks learning progress, quiz scores, and certificates. Smooth HR **Employee Compliance** is updated separately by HR when a regulatory or policy requirement is satisfied. Download LMS PDFs and attach them to [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents), then mark the matching compliance row **Complete** with the correct renewal date.

### Where should quiz PDFs be stored for audits?

Use [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) on the employee record with an appropriate **Employee Document Type** (for example Training Record or Policy Acknowledgment). Include the **Quiz Submission Report** PDF exported from LMS. For organization-wide retention policies, align document type expiry settings with [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) renewal periods.

### Which desk workspace manages LMS content?

Open the **Learning** workspace from the app switcher. Desk paths use `/app/list name` slugs—for example `/app/lms-quiz` and `/app/lms-enrollment`. Learners consume training at `/lms` on the same site.

### How do new hires get enrolled in mandatory training?

When **Employee Onboarding** is created in HRMS, the LMS integration enrolls the employee user in every published **Mandatory** course and creates **LMS Training Assignment** rows with default due dates. Ensure the **Employee** record has a linked **User** with the **LMS Student** role.

### What is the difference between an LMS Certificate and HR compliance?

An **LMS Certificate** proves course completion inside Smooth LMS. **Employee Compliance** in Smooth HR tracks regulatory obligations (training renewals, I-9, background checks) with scheduled expiry alerts. Course certificates do not automatically appear on the HR compliance ledger—HR attaches LMS PDFs to [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) and updates [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) when policy requires.

### Can managers view their team's quiz scores?

Managers with **Moderator** or **Course Creator** roles can open **LMS Quiz Submission** list views filtered by course and member. The **Statistics** dashboard summarizes average assessment scores by course. For official personnel files, export PDFs and store under the employee's HR documents rather than sharing desk login credentials.

## Glossary

| Term | Definition |
|------|------------|
| **LMS Course** | Training container with chapters, lessons, and assessments |
| **LMS Enrollment** | Links a User (employee) to a course with progress tracking |
| **LMS Quiz** | Assessment document composed of linked questions |
| **LMS Quiz Submission** | Record of one learner attempt with scored results |
| **LMS Training Assignment** | Due-date tracker for assigned mandatory training |
| **LMS Certificate** | Issued credential after course or evaluation completion |
| **Mandatory course** | Published course flagged for auto-enrollment on onboarding |
| **Cohort (LMS Batch)** | Scheduled group of learners with shared live sessions and assessments |
| **Employee Document** | HR file-cabinet record for attachments on the employee profile |
| **Employee Compliance** | HR ledger for regulatory and policy compliance status with renewals |
## Smooth LMS + Smooth HR capability map

Use **Smooth LMS** for training delivery and assessments, and **Smooth HR** for employee files and compliance records — both on the same account.

| Business need | Primary app | How |
|---------------|-------------|-----|
| Online training library | **Smooth LMS** | **LMS Course** with chapters, lessons, video/PDF/SCORM, quizzes, assignments |
| Assign training + track progress | **Smooth LMS** | **LMS Enrollment**, **LMS Training Assignment**, cohort batches, progress dashboards |
| Print completed tests as PDF | **Smooth LMS** | **LMS Quiz Submission** → **Quiz Submission Report** print format |
| Course completion certificates | **Smooth LMS** | **LMS Certificate** with customizable print templates |
| Employee file storage | **Smooth HR** | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) with document types and expiry |
| Regulatory compliance tracking | **Smooth HR** | [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) with **Compliance Type** renewals |
| New hire document collection | **Smooth HR** | **Employee Onboarding** portal + e-signatures |

Course completion certificates from LMS are separate from HR compliance records until HR explicitly files them. Attach LMS PDFs to **Employee Document** or update **Employee Compliance** when a training record must appear on the official employee file for audits.
## LMS roles reference

| Role | Capabilities |
|------|----------------|
| **System Manager** | Full desk access; configure LMS Settings, print formats, AI keys |
| **Moderator** | Manage all courses, quizzes, enrollments, certificates, statistics |
| **Course Creator** | Author courses, quizzes, assignments; view learner submissions for own content |
| **Batch Evaluator** | Grade submissions, conduct certificate evaluations, manage cohort assessments |
| **LMS Student** | Access `/lms` portal; take quizzes; view own certificates and assignments |

HR users without LMS roles can still manage [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) and [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) records when L&D provides exported PDFs.
## Connecting training records to Smooth HR

Smooth LMS and Smooth HR share one account. Completing a course does not automatically update HR compliance—you connect the two when your policy requires it.

| LMS artifact | HR destination | When to use |
|--------------|----------------|-------------|
| **LMS Certificate** PDF | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) | Store course completion certificate on the employee file |
| **Quiz Submission Report** PDF | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) | Retain scored test results (safety quizzes, policy acknowledgments) |
| Mandatory training status | [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) | Track renewal dates, expiry alerts, and audit-ready compliance status |

**Recommended workflow:** When an employee completes mandatory training and passes required assessments, download the LMS certificate or quiz PDF from the Learning portal or desk, then attach it to an **Employee Document** or update the corresponding **Employee Compliance** record. HR Managers can configure **Compliance Type** with renewal periods so expiring certifications trigger scheduled reminders—complementing LMS **Training Assignment** due dates.

New hires enrolled via **Employee Onboarding** may receive automatic LMS enrollments for courses marked **Mandatory**; HR still uses **Employee Compliance** for regulatory items (I-9, background checks) that live outside LMS.
---

## Related guides

- [Enrollments Overview](https://smoothhiring.com/help/lms/enrollments/overview)
- [Training Assignments](https://smoothhiring.com/help/lms/enrollments/training-assignments)
- [Employee Compliance (HRMS)](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance)

---

_Last updated: May 2026_