User Guide: Inspector Certification Tracking

Last updated: January 15, 2026 Related Stories: US-40

---

Overview

Inspector Certification Tracking enables administrators to manage inspector qualifications, licenses, and certifications with expiration date monitoring. This ensures only qualified inspectors are assigned to inspections they're certified to perform, and provides proactive alerts when certifications are approaching expiration.

Implementation Note: Inspector specialties and property types are defined as system types in the Calendar App. Full certification tracking with expiration dates, renewal workflows, and document management requires configuration using Entity Manager fields on your Inspector or User entity.

---

Prerequisites

Before configuring certification tracking, ensure:

• User has System Administrator or HR Manager role
• Inspector entity exists with certification fields
• Inspectors are created in the User Management system
• Automation Builder access for expiration notifications (optional)

---

Understanding the Certification System

Inspector Profile Structure

Each inspector profile includes qualification information:

Certification Fields (Entity Manager Configuration):

Certification Entity Fields

---

Accessing Certification Management

Navigation

1. Log in to the GovAssist Admin Portal
2. Navigate to User Management or Entity Manager
3. Select the Inspectors entity or user list
4. Click on an inspector to view their profile
5. Navigate to the Certifications section or tab

---

Managing Inspector Certifications

Viewing Inspector Qualifications

The inspector profile displays:

Specialty Assignments

Inspectors can be assigned specialties that determine which inspection types they can perform. These are system-defined types:

Note: Specialty types are defined in the system. Custom specialties require code changes to InspectorSpecialty type.

Property Type Assignments

Property types are system-defined categories:

Note: Property types are defined in the system. Custom property types require code changes to PropertyType type.

---

Adding Certifications

Step 1: Open Inspector Profile

1. Navigate to the inspector's user profile
2. Click on the Certifications tab or section
3. Click + Add Certification

Step 2: Enter Certification Details

Step 3: Upload Documentation

1. Click Upload Document
2. Select the certification document (PDF, image)
3. File is attached to the certification record

Step 4: Save and Verify

1. Click Save to create the certification record
2. System validates dates and marks status
3. Certification appears in the inspector's profile

---

Certification Status Management

Status Options

Automatic Status Updates

The system automatically updates certification status based on expiry date:

---

Expiration Tracking

Dashboard Indicators

The Department Manager Dashboard shows:

Expiration Alerts

Configure notifications for certification events:

---

Assignment Validation

Automatic Qualification Checks

When scheduling inspections, the system verifies:

1. Specialty Match: Inspector's specialties include the inspection type
2. Property Type Match: Inspector handles the property category
3. Certification Valid: Required certifications are active
4. Not Expired: All relevant certifications are current

Assignment Blocking

If certification is expired:

Override Process

Managers can override assignment blocks:

1. Click on the blocked inspector
2. Review the certification warning
3. Enter override reason
4. Confirm the assignment

Note: Override actions are logged for audit purposes.

---

Renewal Process

Initiating Renewal

1. Open the expiring certification record
2. Click Initiate Renewal
3. System creates a renewal task
4. Inspector is notified

Submitting Renewal Documentation

The inspector (or administrator) submits:

Completing Renewal

1. Administrator reviews submitted documents
2. Updates certification record:
   • New expiry date
   • New certification number (if changed)
   • Status → Active
3. Previous certification archived for records

---

Bulk Operations

Importing Certifications

For initial setup or updates:

1. Navigate to Entity Manager > Certifications
2. Click Import
3. Upload CSV with columns:
   • inspector_id
   • certification_type
   • certification_number
   • issue_date
   • expiry_date
   • status
4. Review and confirm import

Exporting Certification Reports

Generate reports for:

• All certifications by status
• Expiring within specified period
• By inspector or department
• Historical certification records

---

Certification Types Configuration

Common Certification Categories

Adding Certification Types

1. Navigate to Entity Manager
2. Open Certification Types entity (or dropdown field configuration)
3. Add new certification type options
4. Configure required fields and validation

---

Automation Integration

Expiration Notifications

Create automation rules for certification management:

Example: 90-Day Expiration Warning

Trigger: Schedule (daily at 8 AM)

Conditions:

• Certification expiry_date = 90 days from today
• Certification status = Active

Actions:

1. Send email to inspector
2. Send email to department manager
3. Create renewal reminder task

Example: Assignment Block Check

Trigger: Before appointment creation

Conditions:

• Inspector has expired certifications
• Certification type matches inspection specialty

Actions:

1. Block assignment
2. Display warning message
3. Log attempted assignment

---

Reporting

Certification Status Report

Generate reports showing:

Compliance Report

For government audit requirements:

---

Best Practices

Proactive Management

1. Review Monthly: Check expiring certifications report
2. 90-Day Lead Time: Start renewal process 90 days before expiry
3. Document Everything: Upload all certification documents
4. Track CEU Hours: Monitor continuing education requirements

Assignment Considerations

1. Verify Before Assignment: Ensure certification matches inspection type
2. Cross-Training: Encourage multiple certifications per inspector
3. Backup Coverage: Maintain coverage for each inspection type
4. Seasonal Planning: Consider certification renewals during low-demand periods

Compliance

1. Audit Trail: All changes logged with timestamps
2. Document Retention: Keep historical certification records
3. Regular Audits: Quarterly review of certification compliance
4. Training Records: Link to continuing education tracking

---

Troubleshooting

Common Issues

Q: Inspector is qualified but doesn't appear for assignments. A: Check that their certifications are Active status. Verify the certification type matches the inspection specialty. Ensure the inspector is assigned to the correct calendar.

Q: Certification status shows Expired but was renewed. A: Update the expiry_date field with the new expiration date. Change status to Active. Upload the new certification document.

Q: Cannot add certification to inspector profile. A: Verify you have permission to edit inspector records. Check that the Certifications entity/fields exist. Contact administrator if fields are missing.

Q: Expiration notifications not sending. A: Verify automation is enabled for certification expiration. Check email configuration. Review automation logs for errors.

Q: Assignment override not working. A: Ensure you have manager-level permissions. The override may require additional approval. Check audit log for rejection reasons.

---

Related Documentation

• User Accounts & Profile
• Inspector Assignment
• Department Manager Dashboard
• Inspection Type Management
• Automation Builder

---

Technical Reference

Source Components:

• Inspector Service: apps/calendar-app/src/services/Inspector/
• Inspector Types: apps/calendar-app/src/pages/Calendar/components/RouteMapTab/types.ts
• Specialty Configuration: apps/calendar-app/src/pages/Calendar/components/RouteMapTab/const.ts
• User Service: repos/govassist-user-service/

Note: The current codebase defines inspector specialties and property types. Full certification tracking with expiration dates should be implemented as entity fields in the User or Inspector entity within Entity Manager.

---

For additional assistance, contact your System Administrator.