Skip to main content

Agency Activities

The Agency Activities page gives administrators a comprehensive view of all activity across the organization. Track member hours, validate activity entries, manage activity categories, and review the edit audit trail.

Agency Activities


Accessing Agency Activities

  1. Navigate to Activities > All Members from the left sidebar (or the All Members tab on the Activities page)
  2. You must have Administrator, Activity Manager, or Activity Log Viewer permissions

Agency Statistics

Five stat cards at the top summarize agency-wide activity:

StatDescription
Unique ActivitiesNumber of different activities with participation
ParticipationsTotal activity sessions logged across all members
Service HoursCumulative hours across the agency
MilesTotal miles traveled by all members
MembersTotal agency member count

Use the MTD / YTD / Lifetime toggle to change the time period.


Filtering Activities

The Agency Activities page provides powerful filtering to find specific entries:

FilterDescription
SearchFull-text search across user names, titles, descriptions, locations, categories, and notes
User FilterMulti-select dropdown to filter by specific members
Category FilterFilter by activity category type
Status FilterFilter by validation status (Pending, Validated, Rejected) - only shown when validation is enabled
Time PeriodMTD, YTD, or Lifetime toggle

Activity Display

Desktop View (Data Grid)

Activities appear in a data grid with the following columns:

ColumnDescription
Date / TimeDate on top, start-end time range below
UserMember name, formatted as "Last, First"
CategoryColor-coded icon and category name
TitleActivity title
LocationWhere the activity took place
DurationTime spent (or "Active" if still ongoing)
MilesDistance traveled
TypeQR Code or Manual entry indicator
StatusValidation status badge (only shown when validation is enabled)

Default sort: Most recent activities first, then alphabetical by member last name within the same date.

Left-aligned cell content: User, Category, Title, and Location columns have their values left-justified for readability; headers remain centered.

Selecting and Bulk-Deleting Activities

Admins can select multiple activities and delete them in a single operation:

  1. Check the boxes next to the rows you want to delete (left edge of each row)
  2. A Delete N Selected button appears in the filter row
  3. Click it to open a confirmation dialog showing:
    • Number of records selected
    • How many users are affected
    • Total hours that will be removed
  4. Confirm to delete all selected activities
note

There's no "select all" checkbox in the header — this prevents accidental bulk actions. Admins must intentionally select each row (or use the checkbox on a filtered page to scope the selection).

caution

Bulk delete is permanent. Deleted activities cannot be recovered and hours are immediately subtracted from affected users' totals.

Mobile View

On mobile, activities display as cards with the same information in a stacked, touch-friendly layout. The mobile view uses per-card edit and delete buttons instead of bulk selection.


Activity Categories

Activity categories organize events and activities by type. They determine how hours are classified for reporting and compliance.

Configuring Categories

Navigate to Agency Settings > Activity Categories to manage categories.

Each category has:

FieldDescription
NameDisplay name (e.g., "Skills Training")
CodeAuto-generated identifier
DescriptionWhat this category covers
ColorVisual color on calendars and reports
IconMaterial icon for visual identification
Counts Toward TrainingHours count toward training requirements
Counts Toward DeploymentHours count toward operational requirements
Counts Toward MembershipHours count toward membership requirements

Default Categories

New agencies receive a standard set of categories:

CategoryTrainingDeploymentMembership
Search and Rescue-YesYes
Medical Emergency-YesYes
Fire Response-YesYes
Water Rescue-YesYes
Technical Rescue-YesYes
Skills TrainingYes-Yes
Physical TrainingYes-Yes
Equipment TrainingYes-Yes
Drill ExerciseYes-Yes
Team Meeting--Yes
Equipment Maintenance---
Community Event--Yes
Public Education--Yes
Standby Coverage-YesYes
Fundraising---
Other---

Managing Categories

  • Add custom categories specific to your agency
  • Deactivate categories you don't use (inactive categories are hidden from dropdowns)
  • Default categories cannot be deleted but can be deactivated
  • Categories in use (with logged activities) cannot be deleted

Activity Validation

Agencies can require manual activity entries to be reviewed before they're considered official.

Enabling Validation

Activity validation is configured in Agency Settings > Record Settings:

  • Toggle Require Activity Log Validation on or off
  • When enabled, all manual activity entries start with "Pending" status
  • Event check-in entries are auto-validated (since the system records them)

Validation Workflow

Validation Status Badges

Status is displayed as an icon-only badge (hover for tooltip):

IconColorStatus
HourglassOrangePending Validation
Shield with checkmarkGreenValidated
Circle with XRedRejected

The Status column is only shown in the table when at least one record in the agency has a validation status set.

Reviewing Pending Activities

  1. Navigate to Agency Activities
  2. Filter by Status: Pending to see entries awaiting review
  3. Click an activity to open the detail modal
  4. In the modal footer, click Validate to approve or Reject to deny
  5. Optionally add validation notes explaining your decision

Retroactive Validation

The Validate and Reject buttons are available for activities in any status (not just Pending):

  • Null status (record pre-dates the validation requirement) — both buttons shown
  • Pending — both buttons shown
  • Validated — only Reject shown (to reverse)
  • Rejected — only Validate shown (to reverse)

This lets admins validate legacy records after enabling the validation setting, and reverse mistaken decisions.

Who Can Validate

RoleCan Validate
Administrator / Super AdminYes
Activity Manager permissionYes
User Activity Approver permissionYes
Regular MembersNo

Editing Activities

Administrators can edit any activity in the agency. The system enforces a tiered permission model to maintain data integrity.

Permission Tiers

WhoCan EditConstraints
Record OwnerTheir own recordsWithin 72 hours of creation. Cannot edit validated records.
AdminAny record in agencyMust provide a reason when editing another user's record.
ValidatorValidation fields onlyCan only change validation status and notes.

Opening the Detail Modal

Both the admin and member use the same activity detail modal, which has two layouts:

  • Modal view (centered dialog, ~900px wide)
  • Side panel view (slides in from the right edge)

Toggle between them using the ↗ / ↙ icon in the modal header. Your preference is remembered across sessions.

The modal's tabs are: General → My Notes → Training → Timeline (Training only appears for TRAINING-category records, My Notes only for the record owner).

Editing Another User's Record

When an admin edits a member's activity:

  1. Click the activity row to open the detail modal
  2. Click Edit in the modal footer (available to admins on any activity, not just manual entries)
  3. Make the necessary changes in the edit form
  4. Provide a reason for the edit (required when editing another user's record)
  5. Save — the edit is logged in the audit trail

Admin Override

For validated or expired-window records that need correction:

  1. Open the edit dialog
  2. Toggle Admin Override on
  3. Provide a reason for the override
  4. Save - the override is logged and flagged on the record
caution

Admin overrides are tracked and visible in the audit trail. Use them only when corrections are genuinely needed.


Edit Audit Trail

Every edit to an activity log is tracked for accountability. This creates a complete history of who changed what and why.

What's Tracked

For each edit, the system records:

FieldDescription
WhoThe user who made the edit
WhenTimestamp of the edit
ReasonWhy the edit was made (if provided)
ChangesField-by-field diff showing old and new values
Admin OverrideWhether override permissions were used
Editing OthersWhether someone edited another user's record

Viewing Edit History

  1. Click an activity to open the detail modal
  2. If the activity has been edited, you'll see:
    • An edit metadata bar showing edit count, last editor, and date
    • Admin Override badge (orange) if override was used
    • Hours Adjusted badge (blue) if hours were manually changed
  3. Click Edit History to expand the full audit trail
  4. Each entry shows who, when, why, and exactly what changed

Edit Indicators

Activities with edits show visual indicators:

IndicatorMeaning
Edit countNumber of times the record was modified
Admin Override badgeAn admin used override permissions
Hours Adjusted badgeHours differ from the calculated duration

Form Validation

The system validates activity data to prevent errors:

Hard Errors (Block Saving)

RuleDescription
End time must be after start timePrevents impossible time ranges
Hours must be 0-24No negative or unrealistic values
Miles must be non-negativeNo negative mileage

Soft Warnings (Allow Saving)

RuleDescription
Miles over 500Prompts for confirmation but allows saving

These validations run on both the frontend form and the backend API for consistency.


Active Events

The Agency Activities page shows currently running events at the top of the page, including:

  • Event title and category
  • Number of participants checked in
  • Quick access to event details

Required Permissions

FeatureRequired Permission
View Agency ActivitiesAdmin, Activity Manager, or Activity Log Viewer
Edit any activityAdmin or Activity Manager
Delete activities (single or bulk)Admin or Activity Manager
Validate/Reject activitiesAdmin, Activity Manager, or Activity Approver
Manage Activity CategoriesAdmin or Event Manager

Configure permissions in Groups and Permissions.