Safety Hub App Overview

Report incidents, track safety observations, run toolbox talks with attendance, monitor certification compliance, and generate OSHA reports — all from a centralized workplace safety platform built into MangoApps Workforce.

---

What is Safety Hub?

Safety Hub is the workplace safety management system inside MangoApps Workforce. It brings incident reporting, behavioral safety observations, toolbox talk meetings, certification tracking, OSHA compliance reporting, and a safety knowledge base into a single, connected platform. Employees can report incidents and submit observations from any device, managers can investigate events and run safety meetings, and administrators can track regulatory compliance across the entire organization.

The module integrates with Shifts (linking incidents to specific shifts), Training (connecting certifications to training courses), Skills & Certifications (aggregating credential data from multiple sources), and Performance Management (factoring safety incidents into performance scores).

Core Value Proposition:

• 🚨 Incident Management — Report, investigate, and close incidents with a full audit trail from initial report through root cause analysis to corrective actions
• 👁️ Safety Observations — Capture positive behaviors, at-risk conditions, and near-miss events with optional anonymous reporting and follow-up tracking
• 🗣️ Toolbox Talks — Schedule safety meetings, manage a topic library, record attendance with digital signatures, and track completion rates
• 📜 Certification Tracking — Monitor certification status across three data sources (skills, training certificates, external LMS), flag expirations, and identify training gaps
• 📊 OSHA Compliance — Calculate TRIR and DART rates, generate OSHA 300 Log, Form 300A, and Form 301 reports directly from incident data

---

At a Glance

🚨 Incidents	👁️ Observations	🗣️ Toolbox Talks	📜 Certifications
7 incident types, 4 severity levels, full investigation workflow	Positive, at-risk, near-miss with anonymous option	Schedule, facilitate, track attendance with signatures	Multi-source aggregation, expiry alerts, gap analysis

📊 OSHA Compliance	📖 Knowledge Base	📈 Analytics	⚙️ Settings
TRIR, DART, 300 Log, 300A, 301 forms	Safety procedures, hazard guides, emergency response	Incident trends, observation breakdowns, location metrics	Module toggles, notification rules, configurable deadlines

Perfect For:

• 👤 Employees — Report incidents, submit safety observations (anonymously if enabled), attend toolbox talks, review safety articles
• 👥 Managers — Investigate incidents, assign corrective actions, facilitate toolbox talks, monitor certification compliance, run analytics
• 🏢 HR / Admin — Configure safety requirements, manage certification rules, generate OSHA reports, define observation campaigns

---

How It Works

Safety Hub Lifecycle

┌─────────────────────────────────────────────────────────────────────────┐
│                       SAFETY HUB LIFECYCLE                              │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌───────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐  │
│  │  PREVENT   │──▶│   OBSERVE   │──▶│   RESPOND   │──▶│   IMPROVE   │  │
│  │            │   │             │   │             │   │             │  │
│  │ Toolbox    │   │ Safety      │   │ Incident    │   │ Root Cause  │  │
│  │ Talks &    │   │ Observations│   │ Reporting & │   │ Analysis &  │  │
│  │ Knowledge  │   │ & Campaigns │   │ Investigation│  │ Corrective  │  │
│  │ Base       │   │             │   │             │   │ Actions     │  │
│  └───────────┘   └─────────────┘   └─────────────┘   └─────────────┘  │
│        │                │                 │                 │           │
│        ▼                ▼                 ▼                 ▼           │
│  ┌─────────────────────────────────────────────────────────────────┐   │
│  │              COMPLIANCE & REPORTING                              │   │
│  │  Certification Tracking · OSHA Logs · Analytics · Dashboards    │   │
│  └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Module Architecture

Safety Hub is organized into independently toggleable modules. Each can be enabled or disabled through the app configuration:

Module	Configuration Key	Default
Incidents	incidents_enabled	Enabled
Observations	observations_enabled	Enabled
Toolbox Talks	toolbox_talks_enabled	Enabled
Certifications	certifications_enabled	Enabled
Knowledge Base	Always on	Enabled
Analytics	Always on (managers+)	Enabled

---

🚨 Incident Management

The incident module provides a complete lifecycle for reporting, investigating, and resolving workplace safety events.

Incident Types

Safety Hub supports seven standard incident classifications:

Type	Badge Color	Description
Injury	🔴 Danger	Physical harm to a person
Near Miss	🟡 Warning	Close call with no actual harm
Property Damage	🔵 Info	Damage to equipment or facilities
Environmental	🟢 Success	Spills, emissions, or environmental impact
Security	⚫ Dark	Security breaches or threats
Vehicle Accident	🔵 Primary	Vehicle-related incidents
Equipment Failure	⚪ Secondary	Machinery or tool failures

Severity Levels

Every incident is classified with one of four severity levels:

Severity	Auto-Investigation?	Description
Low	No	Minor event, no immediate danger
Medium	No	Moderate event, localized impact
High	Yes	Significant event requiring formal investigation
Critical	Yes	Major event, potential fatalities or widespread harm

High and critical incidents, as well as any injury-type incidents, automatically trigger the investigation workflow.

Investigation Workflow

┌──────────┐    ┌──────────────┐    ┌──────────────────┐    ┌────────┐
│ REPORTED │───▶│ INVESTIGATING │───▶│ INVESTIGATION     │───▶│ CLOSED │
│          │    │              │    │ COMPLETED          │    │        │
│ Employee │    │ Investigator │    │ Findings & Root   │    │ Manager│
│ submits  │    │ assigned     │    │ Cause documented  │    │ closes │
└──────────┘    └──────────────┘    └──────────────────┘    └────────┘
      │                │                      │
      │     ┌──────────┘                      │
      │     ▼                                 ▼
      │  Configurable                  OSHA Recordability
      │  deadline                      Determination
      │  (default 7 days)             (if applicable)
      ▼
 Auto-assign
 investigator
 (if configured)

Key investigation features:

• Auto-assignment — When enabled, investigators are automatically assigned based on location safety officer, then location manager, then business admin
• Configurable deadlines — Investigation due dates are set based on the investigation_deadline_days configuration (default: 7 days)
• Investigation types — Preliminary (low/medium severity), formal (high severity), or comprehensive (critical severity)
• Root cause analysis — Document findings, root cause, and corrective actions when completing an investigation
• OSHA recordability — Determine whether the incident is OSHA recordable with supporting notes

Platform Integrations

Incidents connect to other MangoApps modules:

• Shift linking — Link an incident to the specific shift during which it occurred; auto-populates location
• Attendance impact — Flag incidents that affect employee attendance; track days off work and modified duty
• Performance scoring — Injury incidents can factor into performance impact scores based on severity and work restrictions
• Schedule adjustments — Incidents requiring time off or modified duty are flagged for schedule adjustment
• Escalation — High/critical incidents trigger the escalation engine, which handles multi-channel notification delivery with acknowledgment tracking

Reporting & Export

• Print report — Generate a printable incident report for any single incident
• Bulk print — Print multiple incident reports at once
• CSV export — Export all incidents with ID, date, type, severity, status, location, and description
• Analytics dashboard — View incident totals, breakdowns by type/severity/status with configurable date ranges (7 days, 30 days, 90 days, 1 year)

---

👁️ Safety Observations

Safety observations let every employee contribute to a safer workplace by reporting what they see — good behaviors, risky conditions, and near-miss events.

Observation Types

Type	Icon	Severity	Purpose
Positive	👍	Low	Recognize safe behaviors and good practices
At-Risk	⚠️	Medium	Flag unsafe behaviors or hazardous conditions
Near Miss	⚡	High	Document close calls that could have been incidents

Key Features

• Anonymous reporting — When allow_anonymous_observations is enabled, employees can submit observations without identifying themselves
• Photo attachments — Attach photos via Active Storage to document conditions visually
• Follow-up tracking — Flag observations that require follow-up action; managers can mark follow-up as complete with audit trail
• Location tagging — Associate observations with specific business locations plus a free-text specific location field
• Category filtering — Observations are categorized for trend analysis; categories are configurable per business
• My Observations — Employees see a filtered view of their own submissions

Status Flow

Status	Description
Submitted	Initial state when observation is created
Under Review	Manager is reviewing the observation
Resolved	Follow-up action completed or issue addressed
Closed	Observation fully processed

At-Risk Notifications

When an at-risk or near-miss observation is submitted, the notification service automatically alerts relevant managers and safety officers, enabling rapid response to developing hazards.

Observation Analytics (Managers)

Managers access a dedicated analytics view showing:

• Total observation counts over configurable date ranges
• Breakdown by observation type (positive vs. at-risk vs. near-miss)
• Breakdown by category
• Breakdown by location

---

📢 Observation Campaigns

Observation campaigns are time-bound drives that encourage employees to submit safety observations toward a collective goal.

Campaign Lifecycle

Status	Description
Draft	Campaign created but not yet active
Active	Campaign running, accepting observations
Completed	Campaign goal met or manually completed
Cancelled	Campaign stopped before completion

Campaign Features

• Target goals — Set a target number of observations for the campaign
• Progress tracking — Real-time percentage of goal reached based on linked observations
• Duration tracking — Days remaining calculated from start/end dates
• Focus areas — Define focus categories and focus locations for targeted campaigns
• Rewards — Optional reward configuration with description and points value
• Linked observations — All observations submitted during a campaign can be linked to track contribution

---

🗣️ Toolbox Talks

Toolbox talks are short safety meetings (typically 10–15 minutes) held regularly to discuss specific safety topics with crews.

Meeting Lifecycle

┌───────────┐    ┌─────────────┐    ┌───────────┐    ┌───────────┐
│ SCHEDULED │───▶│ IN PROGRESS │───▶│ COMPLETED │    │ CANCELLED │
│           │    │             │    │           │    │           │
│ Manager   │    │ Facilitator │    │ Attendance│    │ Meeting   │
│ schedules │    │ starts      │    │ finalized │    │ cancelled │
│ meeting   │    │ meeting     │    │           │    │           │
└───────────┘    └─────────────┘    └───────────┘    └───────────┘

Scheduling & Facilitation

• Schedule talks — Set date/time, duration (default from config), location, and facilitator
• Topic assignment — Select from the topic library or create a custom title
• Expected attendees — Pre-assign expected attendees for attendance rate calculation
• Calendar view — Month-by-month calendar showing all scheduled talks
• Upcoming / Completed filters — Quick views for upcoming and completed talks

Attendance Tracking

• Digital attendance — Record who attended with timestamp
• Signature capture — When require_attendance_signature is enabled, attendees must provide a signature
• Acknowledgment — Attendees confirm they understood the content
• Missing attendees — System identifies who was expected but did not attend
• Attendance rate — Automatic calculation of actual vs. expected attendees
• Print attendance — Generate a printable attendance sheet for documentation

Topic Library

The topic library provides a catalog of pre-built and custom safety topics:

• 20+ categories — PPE, Emergency Procedures, Fire Safety, Hazard Awareness, Ergonomics, Chemical Safety, Electrical Safety, Fall Prevention, Machine Safety, Vehicle Safety, Housekeeping, First Aid, Heat/Cold Stress, Respiratory Protection, Lockout/Tagout, Confined Spaces, Ladder Safety, Hand Tool Safety, Material Handling, Workplace Violence
• System templates — Pre-built topics that come with the platform
• Custom topics — Create business-specific topics with content and attachments
• Topic duplication — Clone existing topics as a starting point for new ones
• Training integration — Link topics to Training app courses for follow-up learning
• Category filtering — Browse and filter the library by category
• Usage tracking — See how many times each topic has been used and when it was last used

---

📜 Certification Tracking

The certifications module aggregates credential data from three different sources into a unified compliance view.

Data Sources

┌────────────────────────────────────────────────────────────────────┐
│                   CERTIFICATION DATA SOURCES                       │
├────────────────────────────────────────────────────────────────────┤
│                                                                    │
│  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────────┐ │
│  │  Employee Skills  │  │    Training      │  │  External LMS   │ │
│  │  (Skills &        │  │    Certificates  │  │  Records        │ │
│  │   Certifications) │  │  (Training App)  │  │ (LMS Connect)   │ │
│  │                   │  │                  │  │                 │ │
│  │ • Cert dates      │  │ • Auto-issued    │  │ • Third-party   │ │
│  │ • Expiration      │  │ • PDF generation │  │   completions   │ │
│  │ • Verification    │  │ • Course-linked  │  │ • Provider info │ │
│  │ • Documents       │  │ • Cert numbers   │  │ • Expiry dates  │ │
│  └────────┬─────────┘  └────────┬─────────┘  └───────┬─────────┘ │
│           │                     │                     │           │
│           └─────────────────────┼─────────────────────┘           │
│                                 ▼                                  │
│                    ┌────────────────────────┐                     │
│                    │  Unified Certification │                     │
│                    │  Dashboard             │                     │
│                    │  • Expiring Soon       │                     │
│                    │  • Expired             │                     │
│                    │  • By Employee         │                     │
│                    │  • By Requirement      │                     │
│                    │  • Training Gaps       │                     │
│                    └────────────────────────┘                     │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Certification Status

Each certification is classified into one of three states:

Status	Condition	Color
Active	Expires more than 30 days from now	🟢
Expiring Soon	Expires within 30 days (configurable via certification_reminder_days)	🟡
Expired	Past expiration date	🔴

Views

• Overview — Summary statistics showing total certifications, expiring soon, expired, and active counts plus a list of all certification requirements
• Expiring Soon — All certifications across all sources that will expire within the configured reminder window
• Expired — All certifications that have already expired
• By Employee — Select an employee to see all their certifications from all sources, sorted by expiration date
• By Requirement — Select a certification requirement to see compliance status: compliant employees, non-compliant employees, and expiring employees with compliance rate percentage

Certification Requirements (Admin)

Administrators define what certifications are required:

• Requirement definition — Name, description, category (11 categories: Safety, Equipment Operation, Regulatory Compliance, Emergency Response, Hazardous Materials, First Aid/Medical, Driver/Vehicle, Supervisor/Management, Environmental, Quality, Other)
• Validity period — Configure how long certifications are valid (in months)
• Renewal reminders — Set how many days before expiration to send reminders
• Mandatory flag — Mark requirements as mandatory or optional
• Scoping rules — Apply requirements to specific roles, locations, departments, or job titles
• Training course linking — Connect a requirement to a Training app course so employees know where to get certified

Training Gaps (Managers)

The training gaps report identifies where mandatory certification requirements are not being met:

• Lists each mandatory requirement with the number of non-compliant users
• Shows gap percentage (non-compliant / total affected)
• Displays affected users for each gap (capped at 10 with overflow indicator)
• Sorted by gap count (highest priority first)

---

📊 OSHA Compliance

The OSHA compliance module automatically generates regulatory reports from incident data.

Metrics Dashboard

Metric	Description	Formula
TRIR	Total Recordable Incident Rate	(Recordable Cases × 200,000) ÷ Total Hours Worked
DART	Days Away, Restricted, or Transferred Rate	(DART Cases × 200,000) ÷ Total Hours Worked
Days Away	Total days employees were away from work	Sum of days_away_from_work
Restricted Days	Total days with restricted duty	Sum of days_restricted_work

The dashboard shows year-to-date totals with a monthly breakdown of injuries vs. illnesses.

OSHA Forms

Form	Purpose
OSHA 300 Log	Log of work-related injuries and illnesses for the calendar year, listing each recordable incident with date, type, and classification
OSHA Form 300A	Annual summary — deaths, cases with days away, cases with restrictions, other recordable cases, total days away, total restricted days, injury/illness breakdown
OSHA Form 301	Individual incident report form for a specific recordable incident

Recordability Classification

The system classifies OSHA recordable incidents into:

• Fatality — Death resulting from workplace incident
• Days Away From Work — Employee missed one or more days
• Job Transfer or Restriction — Employee on modified duty
• Other Recordable Cases — Medical treatment beyond first aid

---

📖 Safety Knowledge Base

The knowledge base provides a centralized repository for safety procedures, hazard guides, emergency response plans, and PPE documentation.

Content Management

• Domain-specific — Uses the shared KnowledgeBaseEntry model scoped to the safety domain with pgvector embeddings for semantic search
• Category organization — Articles organized by safety-specific categories (emergency procedures, hazard guides, PPE guides, etc.)
• Full-text search — Search across all knowledge base content
• Display ordering — Control the order articles appear for employees
• OSHA references — Link articles to specific OSHA standards and regulations
• Severity tagging — Tag articles by severity level and related incident types

Employee Self-Service

The Articles view provides a public-facing, employee-friendly interface to browse safety articles grouped by category — enabling on-demand access to safety procedures without requiring manager involvement.

---

🔔 Notifications

Safety Hub sends context-aware notifications across multiple events:

Event	Recipients	Channels
New incident reported	Managers, safety officers (high/critical: escalation engine)	In-app, email
Investigation assigned	Assigned investigator	In-app, email
Investigation overdue	Investigator, managers	In-app, email
At-risk / near-miss observation	Relevant managers, safety officers	In-app
Toolbox talk scheduled	Expected attendees	In-app
Certification expiring	Certificate holder, their manager	In-app, email
Certification expired	Certificate holder, their manager, admin	In-app, email

Escalation Engine

For high-severity and critical incidents, Safety Hub leverages the platform’s escalation engine:

• Multi-channel delivery (in-app, email, voice)
• Acknowledgment tracking per recipient
• Automatic re-escalation if not acknowledged within configured timeframes
• Escalation context includes incident severity, type, and description

---

👤 Role-Based Access

Feature	Employee	Manager	Admin
Report incidents	✅	✅	✅
View own incidents	✅	✅	✅
Investigate incidents	—	✅	✅
Close incidents	—	✅	✅
Delete incidents	—	—	✅
Submit observations	✅	✅	✅
View all observations	✅	✅	✅
Observation analytics	—	✅	✅
Attend toolbox talks	✅	✅	✅
Schedule / facilitate talks	—	✅	✅
Manage topics	—	✅	✅
View certifications	✅	✅	✅
Training gaps report	—	✅	✅
Manage cert requirements	—	—	✅
OSHA compliance dashboard	—	✅	✅
Generate OSHA forms	—	✅	✅
Manage knowledge base	—	✅	✅
Analytics dashboard	—	✅	✅
App settings	—	—	✅

---

⚙️ Configuration Options

Safety Hub is configured through the business marketplace app settings:

Setting	Type	Default	Description
incidents_enabled	Boolean	true	Enable/disable the incidents module
observations_enabled	Boolean	true	Enable/disable the observations module
toolbox_talks_enabled	Boolean	true	Enable/disable toolbox talks
certifications_enabled	Boolean	true	Enable/disable certification tracking
auto_assign_investigators	Boolean	false	Automatically assign investigators to new incidents
investigation_deadline_days	Integer	7	Days allowed for investigation completion
notify_managers_on_incidents	Boolean	true	Send notifications to managers on new incidents
notify_safety_officer_on_high_severity	Boolean	true	Alert safety officers for high/critical incidents
allow_anonymous_observations	Boolean	false	Allow anonymous safety observation submissions
require_photos_for_injuries	Boolean	false	Require photo evidence for injury incidents
require_attendance_signature	Boolean	false	Require signatures for toolbox talk attendance
default_talk_duration	Integer	15	Default duration in minutes for toolbox talks
certification_reminder_days	Integer	30	Days before expiration to send reminders
notify_on_toolbox_talks	Boolean	true	Notify attendees when a toolbox talk is scheduled
allowed_roles	Array	[member, manager, admin, super_admin]	Roles allowed to access Safety Hub

---

Sidebar Navigation

Safety Hub organizes its features into a sidebar with the following tabs:

Tab	Icon	Visible To	Sub-Actions
Dashboard	th-large	All users	—
Incidents	exclamation-triangle	All users (if enabled)	—
Observations	eye	All users (if enabled)	All Observations, My Observations, Campaigns, Analytics (managers)
Toolbox Talks	users	All users (if enabled)	All Talks, Upcoming, Completed, Calendar, Topic Library
Certifications	certificate	All users (if enabled)	Overview, Expiring Soon, Expired, By Employee, Training Gaps (managers), Manage Requirements (managers)
Knowledge Base	book	All users	—
Analytics	chart-bar	Managers+	—
Settings	cog	Admins only	—

---

Tips & Best Practices

1. Encourage positive observations — A healthy observation program has more positive observations than at-risk ones. Recognize employees who submit positive observations to reinforce safe behaviors.

2. Use campaigns to drive engagement — Set up quarterly observation campaigns with achievable targets and rewards to build a habit of safety awareness.

3. Link topics to training — Connect toolbox talk topics to Training app courses so attendees can access deeper learning material after the meeting.

4. Define certification requirements early — Set up mandatory certification requirements with proper scoping (roles, locations, departments) to get accurate training gap analysis from day one.

5. Review OSHA metrics monthly — Use the OSHA compliance dashboard to track TRIR and DART trends. A rising rate signals the need for targeted intervention before regulatory scrutiny.

6. Build the knowledge base proactively — Populate the safety knowledge base with emergency procedures and PPE guides before they are urgently needed. Employees should know where to find safety information at all times.

7. Configure auto-assignment — Enable auto_assign_investigators for faster response to high-severity incidents. The system will route to the location safety officer, then location manager, then business admin.

8. Use anonymous observations wisely — Enabling anonymous observations lowers the barrier for reporting at-risk conditions, but make sure managers respond to every anonymous report to maintain trust.