SCRUM-325-REWARD-EP-6

[Jeemyy]

Specification:

HTTP Endpoint: GET /api/v1/rewards/{id}/analytics

Query Parameters: RewardTransactionFilterQueryDto (dateFrom, dateTo, timelinePeriod [Monthly/Weekly], searchTerm, pageNumber, pageSize)

Response: RewardAnalyticsDto (200 OK)

Authorization: Requires RewardManagement.View permission or HRAdmin/Admin/SuperAdmin role.

CQRS & Endpoint Logic:

Define GetRewardAnalyticsQuery record with Id and RewardTransactionFilterQueryDto.

Verify RewardItem exists (throw 404 if missing).

Aggregate Redemption Rate Timeline:

Query RewardRedemptions for reward within date bounds (default: trailing 6 months).

Group records by calendar month (or week if timelinePeriod == "Weekly").

Project into RedemptionTimelinePointDto (PeriodLabel, DateFrom, DateTo, RedemptionCount, TotalPointsSpent).

Query Paginated Reward Transactions Ledger:

Query RewardRedemptions for reward eager loading Employee, Department, and RewardVoucher.

Filter by searchTerm (employee name, employee code, voucher code).

Order by RedeemedAt DESC, apply pagination (.Skip().Take()).

Project to RewardTransactionItemDto formatting employee details, voucher code, timestamp, and points deducted.

Assemble and return RewardAnalyticsDto.

Implement Controller action GetRewardAnalytics in RewardsController.cs calling _mediator.Send(query).

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hr-system	Ready	Preview	Sep 17, 2026 2:52pm UTC

[github-actions]

Automated PR Validation Feedback

All Checks Passed!

• Jira key / Task reference detected.
• Code formatting passed (4 changed C# file(s)).
• .NET 10 solution compiled successfully.
• .NET analyzers passed.
• Security scan skipped (no dependency changes in this PR).

Ready for maintainer review!