User Guide: Inspector Assignment & Reassignment
Last updated: January 15, 2026
Overview
The Inspector Assignment & Reassignment feature allows inspectors to flag scheduling conflicts and request reassignment before their workday begins. This ensures inspections are completed even when an assigned inspector is unavailable.
Key Features
- Reassignment Requests - Inspectors can flag conflicts before 8 AM
- Manager Notification - Supervisors are alerted to pending reassignments
- Cutoff Enforcement - Same-day changes require early notification
- Audit Trail - All assignment changes are tracked
For Inspectors
Understanding Your Daily Assignments
Each morning, your inspection assignments are visible in:
- The Calendar App dashboard
- Your email notifications (if configured)
- The mobile inspection interface
Your assignments include:
- Property address and location
- Permit type and inspection type
- Scheduled time window
- Applicant contact information
- Special notes or instructions
When to Request Reassignment
Request reassignment when you have:
- Personal conflict - Appointment, illness, emergency
- Vehicle/equipment issues - Unable to travel to site
- Geographic conflict - Other urgent inspections in different area
- Certification issue - Inspection requires certification you don't hold
- Safety concern - Known site hazard requiring different preparation
How to Request Reassignment
Step 1: Identify the Inspection
- Open the Calendar App or mobile interface
- Navigate to your assigned inspections for the day
- Locate the inspection you cannot complete
Step 2: Change Status to Request Reassignment
- Click on the inspection appointment
- Click the three-dot menu or Status dropdown
- Select "Require Reassignment" status
- A notification is queued to your manager
Step 3: Provide Reason (If Available)
If a reason field is displayed:
- Select the reason category (conflict, illness, equipment, etc.)
- Add any relevant notes
- Click Save or Submit
Note: The detailed reason field is planned for a future release. Currently, inspectors should message their manager directly with specifics.
Cutoff Time for Same-Day Changes
Same-day reassignment requests must be submitted before 8:00 AM.
| Time of Request | What Happens |
|---|---|
| Before 8 AM | Request processed, manager notified, reassignment initiated |
| After 8 AM | Request noted, but you may need to complete the inspection or contact manager directly |
After Requesting Reassignment
Once you've requested reassignment:
- Check for confirmation - Your manager may approve or contact you
- Monitor your schedule - The inspection may be removed from your queue
- Stay available - You may be reassigned other inspections instead
- Follow up if needed - If you don't hear back, contact your manager
For Managers / Supervisors
Receiving Reassignment Notifications
When an inspector requests reassignment:
- You'll receive a notification (email/in-app)
- The inspection shows "Require Reassignment" status
- The inspector's name and reason appear in the notification
Handling Reassignment Requests
Option 1: Reassign to Another Inspector
- Open the inspection appointment
- Click "Reassign Inspector" or access the inspector selection
- Review available inspectors:
- See who's available for that time slot
- See who covers that tax map zone
- See workload distribution
- Select the new inspector
- Confirm the reassignment
- Both inspectors are notified of the change
Option 2: Attempt to Resolve with Original Inspector
- Contact the inspector directly
- Discuss the conflict
- If resolved, the inspector can remove the reassignment request
- No change is made to assignments
Option 3: Reschedule the Inspection
- If no inspectors are available
- Contact the applicant/citizen
- Reschedule to a different date/time
- Update the appointment accordingly
Viewing Reassignment Requests
To see all pending reassignments:
- Open Calendar App
- Go to Inspections or Appointments view
- Filter by status: "Require Reassignment"
- See all inspections needing attention
Using the Route Map for Reassignment
The Route Map view helps optimize reassignments:
- Open Calendar App → Route Map tab
- See inspector locations and routes
- Identify inspectors near the property
- Consider travel time and workload
- Use Select Inspector Modal to choose
Select Inspector Modal
When reassigning, the modal shows:
| Element | Description |
|---|---|
| Header | "Select Inspector" with close button |
| Search Field | Search inspectors by name |
| Inspector List | Radio button selection with inspector details |
| Actions | Cancel and Assign buttons |
Inspector List Information:
| Inspector | Specialty | Zone Coverage |
|---|---|---|
| John Smith | Building Inspector | Tax Map 1, Tax Map 2 |
| Jane Doe | Building Inspector | Tax Map 2, Tax Map 3 |
| Mike Johnson | Building, Electrical Inspector | Tax Map 1, Tax Map 2, Tax Map 3 |
Features:
- Search by inspector name
- See inspector specialties (Building, Fire, etc.)
- See property type coverage
- Infinite scroll for large teams
- Radio button selection
Tracking Reassignment History
Activity Log
All reassignments are tracked in the inspection's activity log:
Visible Information:
- Original inspector assignment
- Who requested reassignment (and when)
- Who approved/made the reassignment
- New inspector assignment
- Timestamp of each action
Reassignment Detail View
Located in: Inspections → Activity Log → Reassignment History
Shows:
- Complete chain of custody
- Reason for each reassignment (when provided)
- Manager who approved changes
- Time elapsed between request and reassignment
Best Practices
For Inspectors
- Request early - Submit before 8 AM for same-day conflicts
- Be specific - Provide clear reason for reassignment
- Stay reachable - Manager may have questions
- Check your schedule - May receive different assignments
- Emergency only for late requests - After 8 AM, only true emergencies
For Managers
- Check notifications early - Review before 8 AM
- Consider workload - Don't overload the reassigned inspector
- Geographic efficiency - Assign to inspectors already in the area
- Document patterns - Track frequent reassignment requests
- Communicate changes - Ensure both inspectors are notified
Troubleshooting
For Inspectors
Q: I can't find the "Require Reassignment" status option. A: The option may be:
- Only available before cutoff time
- Restricted based on your role
- Located in a different menu (check three-dot menu)
Q: My manager didn't respond to my request. What do I do? A:
- Contact your manager directly (phone/email)
- If urgent, escalate to another supervisor
- Document the situation for records
Q: Can I request reassignment after 8 AM? A: After cutoff, contact your manager directly. The system may not allow status change, but the manager can manually reassign.
For Managers
Q: I need to reassign but no inspectors are available. A:
- Check other tax map zones for available inspectors
- Consider rescheduling the inspection
- Review upcoming days for better availability
- Contact the citizen about delay
Q: How do I undo a reassignment? A: Simply reassign the inspection back to the original inspector using the same process.
Future Enhancements
Planned improvements to the reassignment system:
- Detailed reason field for reassignment requests
- Automated notification to managers (in development)
- Self-service peer-to-peer swaps
- Bulk reassignment for weather events
Related Features
- Inspector Scheduling & Route Optimization - Daily schedules
- Peer-to-Peer Reassignment - Inspector swaps
- Calendar Permissions - Role-based access
- Zone Management - Tax map assignments
Technical Notes
Component Location: /apps/calendar-app/src/pages/Calendar/components/RouteMapTab/components/SelectInspectorModal/
Status Values:
Scheduled- Normal assignmentRequire Reassignment- Inspector requested changeReassigned- New inspector assigned
Notification Flow:
- Status change triggers manager notification (planned)
- Currently: inspectors message manager directly
For additional assistance, contact your System Administrator.