Purpose Statement

This enhancement gives Fire Inspectors more control over inspection time logs by allowing them to correct automatically logged events and assign a custom date and time to manual time entries.

The goal is to improve time log accuracy when system-generated timestamps are incorrect because of app crashes, network interruptions, false triggers, testing activity, or user error. It also supports retroactive entry of valid inspection activity while preserving visibility into which automatic events were changed.

Background Information

The current Time Log experience distinguishes between automatically logged events and manually entered events, but it does not provide inspectors with enough flexibility to correct inaccurate records.

This story introduces two related improvements:

1. Automatic time log events can be edited or deleted when the Inspection Type allows it.

2. Manual time entries can be created with a user-selected date and time instead of only using the current system timestamp.

Because this feature affects elapsed totals, on-site totals, chronological ordering, and reporting output, it should be treated as a high-impact workflow update.

Key behaviors in scope:

1. Inspection Type–level configuration controls whether automatic events can be edited or deleted.

2. Automatic events display an Edited badge after any saved modification.

3. The Reason field for automatic events remains read-only and system-generated.

4. Deleted automatic events are removed from the visible log and excluded from totals.

5. Manual entries support separate Date and Time fields, defaulted to the current system date and time.

6. Any date/time change triggers chronological re-sorting.

7. Any edit, delete, or added manual entry triggers immediate total recalculation.

Required Permissions

Based on the requirements provided, the following access is required to use this feature:

1. Administrator access to Inspection Type configuration

   • Required to enable or disable the Allow Inspector to Edit Auto Events toggle.

   • This configuration is set at the Inspection Type level.

2. Inspector access to the Time Log

   • Required to open the inspection Time Log.

   • Required to add manual time entries.

   • Required to edit or delete automatic events only when the Inspection Type setting is enabled.

3. Inspection Type–based feature access

   • Even if an inspector can access the Time Log, the ability to edit/delete automatic events depends on whether the Inspection Type has Allow Inspector to Edit Auto Events enabled.

Exact permission names are not defined in the provided requirements and should be confirmed during implementation.

Video

Step-by-Step Guide

Configure the Inspection Type

1. Navigate to the Inspection Type setup page.

2. Locate the Inspection Timer setting.

3. Find the new toggle labeled Allow Inspector to Edit Auto Events next to the Inspection Timer toggle.

4. Turn the toggle on to allow inspectors to edit and delete automatically logged events for that Inspection Type.

5. Save the Inspection Type configuration.

Edit an Automatically Logged Event

1. Open an inspection that uses an Inspection Type with Allow Inspector to Edit Auto Events enabled.

2. Open the Time Log.

1. In the Automatically Logged Events section, locate the event you need to correct.

2. In the Actions column, select the Edit icon.

1. In the edit form or modal, update the available fields:

   1. Date/Time

   2. Elapsed Time

   3. On-Site

2. Review the Reason field. This field is display-only and cannot be changed.

3. Save the event.

1. Confirm the event now shows an Edited badge.

2. Verify the event list re-sorts chronologically and totals refresh immediately.

Delete an Automatically Logged Event

1. Open the Time Log for the inspection.

2. In the Automatically Logged Events section, locate the event to remove.

3. In the Actions column, select the Delete icon.

1. In the confirmation dialog, review the prompt: Are you sure you want to delete this event?

2. Confirm the deletion.

1. Verify the event is removed from the visible Time Log.

2. Confirm the total elapsed time and total on-site time update immediately.

Add a Manual Time Entry with a Custom Date and Time

1. Open the Time Log.

2. Expand the Adjust Inspection Time section.

3. Enter the required time duration in the existing Time field.

4. Select the Date field.

5. Select the Time field.

6. Confirm both fields default to the current system date and time when first opened.

7. Change the Date and/or Time as needed. Past or future values are allowed.

8. Enter a Reason for the manual entry.

9. Set the On-Site checkbox if applicable.

10. Click on Add and then able to edit or delete if needed 

1. Verify the new event appears in the Manually Entered Events section with the selected date and time.

2. Confirm the list re-sorts chronologically and totals refresh immediately.

Best Practices

1. Only edit automatic events to correct genuine inaccuracies such as app crashes, false triggers, or timing mistakes.

2. Leave the system-generated Reason unchanged to preserve the original context of the event.

3. Review chronological order after saving any date/time change, especially when entering retroactive events.

4. Confirm total elapsed time and on-site totals after every correction.

5. Use manual entries with custom date/time when documenting work that happened earlier or outside the current session.

6. Avoid deleting automatic events unless the event was logged in error or should not be part of the record.

7. Consider adding a help tooltip in the UI to explain when editing automatic events is appropriate.

Troubleshooting & FAQs

Why do I not see the Actions column for automatically logged events?

The Actions column only appears when the Inspection Type has Allow Inspector to Edit Auto Events enabled.

Why can I not edit the Reason field on an automatic event?

The Reason field is system-generated and must remain read-only. It is included for transparency but cannot be changed.

What happens when I change the date/time on an automatic event?

The event saves with the updated date/time, the row displays an Edited badge, the list re-sorts chronologically, and totals recalculate. The Elapsed Time value does not automatically change when date/time changes.

What happens when I delete an automatic event?

The event is removed from the visible log and excluded from recalculated totals. The requirements describe this as deletion from the log, while implementation notes should confirm whether backend soft delete is used.

Can I enter a manual time entry for a past or future date?

Yes. Manual entries support user-selected Date and Time values, including past or future timestamps.

Do Date and Time appear as one field or two?

The updated requirements specify separate Date and Time fields in the Adjust Inspection Time section, consistent with the legacy Time Log experience.

Will reports reflect these updates?

Yes. Time log reporting, PDF output, and email reports should reflect updated totals, and modified automatic events should include the Edited indicator where supported.

What should be tested carefully?

Test date/time handling across time zones, chronological ordering with large event sets, and recalculation behavior after edit, delete, and manual entry actions.