[FEAT]: GET /api/v1/blogs/{blog_id}/engagement

[0x00whitecode]

Description

This PR introduces an API endpoint to fetch engagement metrics for a specific blog post. The endpoint provides insights into a post’s popularity by tracking views, likes, comments, and shares.

Key Changes

• Implemented GET /api/v1/blogs/{blog_id}/engagement to retrieve engagement data.
• Tracks and returns:
  • Total Views
  • Total Likes
  • Total Comments
  • Shares (if applicable)
• Optimized view tracking to avoid real-time database writes:
  • Uses Redis for temporary view storage.
  • Batches updates to the database periodically.
• Efficient counting strategies for likes and comments:
  • SQL: Uses COUNT(*) on indexed columns.
  • NoSQL (MongoDB): Stores engagement metrics in a separate collection for performance optimization.

API Response Example

{
  "blog_id": "123",
  "views": 2450,
  "likes": 150,
  "comments": 25,
  "shares": 10
}

Related Issue

#ISSUE1136

Motivation and Context

This feature enables blog authors and administrators to monitor engagement metrics, assess a post’s popularity, and support recommendation systems by identifying high-engagement content.

How Has This Been Tested?

✔️ Unit tests using pytest to verify:
✅ Successful retrieval of engagement data (200).
✅ Handling of non-existent blog posts (404).
✅ Efficient database read operations.
✔️ Mocked Redis caching and batch database updates using unittest.mock.MagicMock.

Screenshots (if applicable)

📊 Engagement metrics retrieved for a blog post.

Types of Changes

• New feature (non-breaking change which adds functionality)
• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

[samuelogboye]

LGTM