Add /analytics/events/track endpoint

[phertyameen]

Description

Add a controller route POST /analytics/events/track exposing a generic client-side event ingestion endpoint (e.g. frontend UI interactions). Validate query params with a DTO (class-validator), guard the route with AnalyticsAdminGuard where the data is sensitive, and delegate the computation to track-event.provider.ts.

Why this matters

This is the API surface the analytics dashboard (frontend) and any external reporting tools will consume for 'a generic client-side event ingestion endpoint (e.g. frontend UI interactions)'.

Files to touch

• backend/src/analytics/analytics.controller.ts
• backend/src/analytics/providers/track-event.provider.ts
• backend/src/analytics/dtos/analytics-query.dto.ts

Acceptance Criteria

• POST /analytics/events/track returns a 200 with the documented response shape
• Invalid query params return a 400 with a clear validation message
• Route is covered by an e2e test in backend/test/analytics.e2e-spec.ts

Notes

This issue is part of the new analytics module effort (tracking, aggregation,
and reporting on player/game activity). Please keep new code inside
backend/src/analytics/ following the same module/controller/service/provider
layout used by existing modules (e.g. progress, streak, quests).

[kiel997]

Hi! I'd like to work on this issue. I have experience with backend development using Node.js and NestJS, including designing and implementing REST API endpoints. I'm comfortable building controllers, services, request validation, and writing clean, maintainable code. I'll follow the project's contribution guidelines and submit a well-tested, well-documented PR. Please assign this issue to me.

[grantfox-oss]

🦊 GrantFox — @kiel997 has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #537)
2. Your PR will be reviewed by the MindBlockLabs maintainers

Good luck! Track your progress on GrantFox.

[kiel997]

Hi! I've synced my fork with the latest upstream/dev and verified that I'm on the latest commit. However, I don't see the backend/src/analytics directory or the files referenced in this issue (analytics.controller.ts, track-event.provider.ts, and analytics-query.dto.ts). Could you let me know if this issue targets another branch or depends on a pending PR? Thanks!

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@kiel997's PR #585 was approved and merged by @phertyameen.

🏆 @kiel997: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (134 total points). Track your full progress on GrantFox.

👏 Great work, @kiel997! Keep contributing to MindBlockLabs.