Feat/frontend ux docs 239

[tanmayShinde-dev]

Related Issue

Fixes #239

Description

This pull request enhances the analytics module by improving response structure and adding insight-driven fields to help organizers better understand performance data.

What changed

• Added human-readable performance labels (excellent / good / average)
• Included lightweight insights for organizer guidance
• Improved analytics response structure for frontend usage
• Added concise inline comments for maintainability

Why this change

Previously, analytics APIs returned only raw numbers, which made it harder for organizers to interpret performance. These enhancements make analytics more meaningful without breaking existing APIs.

Type of PR

• Bug fix
• Feature enhancement
• Documentation update
• Other (specify):

Screenshots / videos (if applicable)

Not applicable (backend-only change).

Checklist

• I have made this change from my own.
• I have taken help from some online resources.
• My code follows the style guidelines of this project.
• I have performed a self-review of my own code.
• I have commented my code, particularly in hard-to-understand areas.
• I have made corresponding changes to the documentation.
• My changes generate no new warnings.
• I have tested the changes thoroughly before submitting this pull request.
• I have provided relevant issue numbers.

[github-actions]

Thank you for submitting your pull request! 🙌 We'll review it as soon as possible. If there are any specific instructions or feedback regarding your PR, we'll provide them here. Thanks again for your contribution! 😊