mirror of
https://github.com/SamyRai/tercul-backend.git
synced 2025-12-27 04:01:34 +00:00
f66936bc4b
This commit implements a robust, production-ready analytics system using an event-driven architecture with Redis and `asynq`. Key changes: - Event-Driven Architecture: Instead of synchronous database updates, analytics events (e.g., views, likes, comments) are now published to a Redis queue. This improves API response times and decouples the analytics system from the main application flow. - Background Worker: A new worker process (`cmd/worker`) has been created to consume events from the queue and update the analytics counters in the database. - View Counting: Implemented the missing view counting feature for both works and translations. - New Analytics Query: Added a `popularTranslations` GraphQL query to demonstrate how to use the collected analytics data. - Testing: Added unit tests for the new event publisher and integration tests for the analytics worker. Known Issue: The integration tests for the analytics worker (`AnalyticsWorkerSuite`) and the GraphQL API (`GraphQLIntegrationSuite`) are currently failing due to the lack of a Redis service in the test environment. The tests are written and are expected to pass in an environment where Redis is available on `localhost:6379`, as configured in the CI pipeline.
20 lines
1.0 KiB
Go
20 lines
1.0 KiB
Go
package domain
|
|
|
|
import "context"
|
|
|
|
import "time"
|
|
|
|
type AnalyticsRepository interface {
|
|
IncrementWorkCounter(ctx context.Context, workID uint, field string, value int) error
|
|
IncrementTranslationCounter(ctx context.Context, translationID uint, field string, value int) error
|
|
UpdateWorkStats(ctx context.Context, workID uint, stats WorkStats) error
|
|
UpdateTranslationStats(ctx context.Context, translationID uint, stats TranslationStats) error
|
|
GetOrCreateWorkStats(ctx context.Context, workID uint) (*WorkStats, error)
|
|
GetOrCreateTranslationStats(ctx context.Context, translationID uint) (*TranslationStats, error)
|
|
GetOrCreateUserEngagement(ctx context.Context, userID uint, date time.Time) (*UserEngagement, error)
|
|
UpdateUserEngagement(ctx context.Context, userEngagement *UserEngagement) error
|
|
UpdateTrendingWorks(ctx context.Context, timePeriod string, trending []*Trending) error
|
|
GetTrendingWorks(ctx context.Context, timePeriod string, limit int) ([]*Work, error)
|
|
GetPopularTranslations(ctx context.Context, workID uint, limit int) ([]*Translation, error)
|
|
}
|