plexus.reports.blocks.feedback_volume_timeline module

class plexus.reports.blocks.feedback_volume_timeline.FeedbackVolumeTimeline(config: Dict[str, Any], params: Dict[str, Any] | None, api_client: PlexusDashboardClient)

Bases: FeedbackAlignmentTimeline

Report block for visualizing feedback-item volume over time.

Supports: - scorecard only: all scores on the scorecard - scorecard + score/score_id: single-score mode

Bucket policy matches FeedbackAlignmentTimeline so volume charts can share the same time-window controls and report-level parameters.

DEFAULT_DESCRIPTION: str | None = 'Feedback item volume over time'

DEFAULT_NAME: str | None = 'Feedback Volume Timeline'

async generate() → Tuple[Dict[str, Any] | None, str | None]

Generates the data for this report block asynchronously.

Access block configuration via self.config and report parameters via self.params. Use self.api_client for data fetching. Use self._log(“message”) to record log information.

Returns:

A tuple containing:

• A dictionary containing the generated data (JSON-serializable), or None on failure.

• A string containing concatenated log messages, or None if no logs.