Skip to main content

Deficiency Reporting

A structured issue-reporting system for documenting equipment problems, damage, or deficiencies with severity classification, status workflow, activity timeline, and repair tracking.

Overview​

DeficiencyReport is polymorphic on Asset or Rack. Reports progress through a defined status workflow with notifications at each stage. Each report maintains an activity feed, a subscriber list, and linked repair records. Notifications are sent to department-scoped managers on creation and to all subscribers on subsequent updates.

Deficiency reporting is designed for AV technicians who discover broken or damaged equipment and for managers who triage and resolve those issues.

Status Workflow​

Reports move through the following statuses:

  1. Open — The deficiency has been filed and is awaiting triage.
  2. In Progress — A team member is actively investigating or addressing the issue.
  3. Resolved — The underlying problem has been fixed.
  4. Closed — The report is finalized and archived.

Status changes trigger notifications to all subscribers on the report.

Key Features​

Severity Levels​

Each deficiency is classified with one of four severity levels, displayed with color-coded indicators throughout the interface:

  • Low — Minor cosmetic or non-urgent issue.
  • Medium — Functional degradation that should be addressed soon.
  • High — Significant impact on operations; requires prompt attention.
  • Critical — Equipment is unsafe or completely non-functional; immediate action required.

Activity Timeline​

All notes, status changes, and repair events are displayed in a single chronological timeline on the report detail page. This provides a complete audit trail from initial filing through resolution.

Send for Repair​

The "Send for Repair" workflow creates a repair record linked to both the deficiency report and the underlying asset. This connects the deficiency lifecycle to the broader repair tracking system.

Subscriptions​

The reporter is automatically subscribed to the deficiency. Additional users can subscribe manually to receive updates. All subscribers are notified when the status changes or new activity is logged.

Dashboard​

The deficiency dashboard sorts reports by severity (critical first) and supports filtering by status. This ensures the most urgent issues are always visible at the top.

Asset Integration​

Asset detail pages include direct links to create a new deficiency report, pre-populated with the asset context. This reduces friction when a technician identifies a problem during routine work.

Proactive Production Notifications​

When a High or Critical deficiency is filed on an asset assigned to a Show Instance with upcoming performances, the production manager is notified proactively. This ensures show-critical equipment issues are surfaced before they affect a performance.