Skip to main content

Flags

A lightweight follow-up tagging system — like a sticky note with priority, due date, and tagged recipients.

Overview

The Flag model is polymorphic and can be attached to Assets, Locations, Racks, Deficiency Reports, Transfers, Inventory Items, or Products. Each flag carries a priority level, an optional due date, a list of tagged users, and an active or resolved lifecycle status.

Key Features

Embedded Flag Button

A flag button is embedded on every flaggable entity's detail page. This makes it fast to create a flag in context without navigating away from the item that needs attention.

Personal Flag Dashboard

The flag dashboard at /flagged displays all flags that a user has created or been tagged in. This provides a centralized view of all outstanding follow-up items.

Priority Levels

Flags support four priority levels:

  • Low — Minor follow-up that can be addressed when convenient.
  • Normal — Standard priority for routine follow-up items.
  • High — Important item that should be addressed soon.
  • Critical — Urgent follow-up requiring immediate attention.

Overdue Detection

Flags with a due date are automatically highlighted when they are past due. This ensures that time-sensitive follow-ups are not overlooked.

Resolution

Flags are resolved with optional resolution notes. This closes the loop on the follow-up item and provides context for what was done.

Filtering

The flag dashboard supports filtering by:

  • Status — Active or resolved.
  • Type — The entity type the flag is attached to.
  • Priority — Low, Normal, High, or Critical.