KPI Comments

AgrEGG includes a structured comment system for KPI-related data. Comments are not just free text notes: they can be attached to a specific scope made of Business Unit, period, KPI, import type, and optional filter items.

What the feature is for

KPI comments are useful when users need to:

  • explain unusual values;

  • document data quality issues;

  • request a follow-up or response from another user;

  • keep contextual notes attached to dashboards, tabular reports, or imported data;

  • distinguish between resolved and still-open discussion items.

Scope of a comment

The codebase shows that comments can be associated with:

  • a KPI;

  • a Business Unit or data view;

  • a period;

  • an import data type;

  • one or more filter items;

  • a graph or a tabular report in some cases.

This means comments are intended to remain contextual, so that users can understand which slice of data a note refers to.

Comment groups and items

The feature distinguishes between comment groups and individual comment items.

In practice this allows the platform to:

  • keep multiple entries inside the same discussion thread;

  • show a shared title or context for related comments;

  • aggregate comments for the same KPI, period, and Business Unit;

  • expose grouped comments in dashboards or report-related views.

Common statuses

The implementation contains flags that support operational workflows, including:

  • comments marked as requiring a response;

  • comments flagged as safe or no longer problematic;

  • temporary comments;

  • comments related to totals in tabular reports.

These states suggest that comments are meant to support review and follow-up processes, not only annotation.

Typical usage

A typical user workflow is:

  • identify the KPI or report entry that needs explanation;

  • open or create the related comment thread;

  • write a comment with the needed business context;

  • mark the item for follow-up if a response is required;

  • review the comment later in the same KPI context, graph, or tabular report;

  • update the discussion until the issue is considered resolved.

Permissions and visibility

Comment visibility is not purely global. The code indicates that users may see comments because:

  • the comment belongs to a Business Unit they can access;

  • the comment was explicitly associated with them;

  • the related KPI scope is visible in their current context.

As a result, two users may not see the same comment list for the same platform area.