mirror of
https://github.com/SamyRai/tercul-backend.git
synced 2025-12-27 02:51:34 +00:00
Key changes include:
- **Architectural Refactoring (CQRS/DTOs):** Refactored the `work` and `translation` application services to use Data Transfer Objects (DTOs) for query responses. This separates the domain layer from the API layer, improving maintainability and performance.
- **Implemented Core Business Logic:** Implemented the `AnalyzeWork` command, which was previously a stub. This command now performs linguistic analysis on works and translations by calling the analytics service.
- **Dependency Injection Improvements:**
- Refactored the configuration loading in `internal/platform/config/config.go` to use a local `viper` instance, removing the reliance on a global singleton.
- Injected the `analytics.Service` into the `work.Service` to support the `AnalyzeWork` command.
- **Comprehensive Documentation:**
- Created a new root `README.md` with a project overview, setup instructions, and architectural principles.
- Added detailed `README.md` files to key packages (`api`, `analytics`, `auth`, `work`, `db`) to document their purpose and usage.
- **Improved Test Coverage:**
- Added new unit tests for the refactored `work` and `translation` query handlers.
- Added a new test suite for the `translation` queries, which were previously untested.
- Added tests for the new `AnalyzeWork` command.
- Fixed numerous compilation errors in the test suites caused by the refactoring.
136 lines
3.8 KiB
Go
136 lines
3.8 KiB
Go
package work
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"tercul/internal/domain"
|
|
|
|
"go.opentelemetry.io/otel"
|
|
"go.opentelemetry.io/otel/trace"
|
|
)
|
|
|
|
// WorkQueries contains the query handlers for the work aggregate.
|
|
type WorkQueries struct {
|
|
repo domain.WorkRepository
|
|
tracer trace.Tracer
|
|
}
|
|
|
|
// NewWorkQueries creates a new WorkQueries handler.
|
|
func NewWorkQueries(repo domain.WorkRepository) *WorkQueries {
|
|
return &WorkQueries{
|
|
repo: repo,
|
|
tracer: otel.Tracer("work.queries"),
|
|
}
|
|
}
|
|
|
|
// GetWorkByID retrieves a work by ID.
|
|
func (q *WorkQueries) GetWorkByID(ctx context.Context, id uint) (*WorkDTO, error) {
|
|
ctx, span := q.tracer.Start(ctx, "GetWorkByID")
|
|
defer span.End()
|
|
if id == 0 {
|
|
return nil, errors.New("invalid work ID")
|
|
}
|
|
|
|
work, err := q.repo.GetByID(ctx, id)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if work == nil {
|
|
return nil, nil
|
|
}
|
|
|
|
return &WorkDTO{
|
|
ID: work.ID,
|
|
Title: work.Title,
|
|
Language: work.Language,
|
|
}, nil
|
|
}
|
|
|
|
// ListWorks returns a paginated list of works.
|
|
func (q *WorkQueries) ListWorks(ctx context.Context, page, pageSize int) (*domain.PaginatedResult[WorkDTO], error) {
|
|
ctx, span := q.tracer.Start(ctx, "ListWorks")
|
|
defer span.End()
|
|
|
|
paginatedWorks, err := q.repo.List(ctx, page, pageSize)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
workDTOs := make([]WorkDTO, len(paginatedWorks.Items))
|
|
for i, work := range paginatedWorks.Items {
|
|
workDTOs[i] = WorkDTO{
|
|
ID: work.ID,
|
|
Title: work.Title,
|
|
Language: work.Language,
|
|
}
|
|
}
|
|
|
|
return &domain.PaginatedResult[WorkDTO]{
|
|
Items: workDTOs,
|
|
TotalCount: paginatedWorks.TotalCount,
|
|
Page: paginatedWorks.Page,
|
|
PageSize: paginatedWorks.PageSize,
|
|
TotalPages: paginatedWorks.TotalPages,
|
|
}, nil
|
|
}
|
|
|
|
// GetWorkWithTranslations retrieves a work with its translations.
|
|
func (q *WorkQueries) GetWorkWithTranslations(ctx context.Context, id uint) (*domain.Work, error) {
|
|
ctx, span := q.tracer.Start(ctx, "GetWorkWithTranslations")
|
|
defer span.End()
|
|
if id == 0 {
|
|
return nil, errors.New("invalid work ID")
|
|
}
|
|
return q.repo.GetWithTranslations(ctx, id)
|
|
}
|
|
|
|
// FindWorksByTitle finds works by title.
|
|
func (q *WorkQueries) FindWorksByTitle(ctx context.Context, title string) ([]domain.Work, error) {
|
|
ctx, span := q.tracer.Start(ctx, "FindWorksByTitle")
|
|
defer span.End()
|
|
if title == "" {
|
|
return nil, errors.New("title cannot be empty")
|
|
}
|
|
return q.repo.FindByTitle(ctx, title)
|
|
}
|
|
|
|
// FindWorksByAuthor finds works by author ID.
|
|
func (q *WorkQueries) FindWorksByAuthor(ctx context.Context, authorID uint) ([]domain.Work, error) {
|
|
ctx, span := q.tracer.Start(ctx, "FindWorksByAuthor")
|
|
defer span.End()
|
|
if authorID == 0 {
|
|
return nil, errors.New("invalid author ID")
|
|
}
|
|
return q.repo.FindByAuthor(ctx, authorID)
|
|
}
|
|
|
|
// FindWorksByCategory finds works by category ID.
|
|
func (q *WorkQueries) FindWorksByCategory(ctx context.Context, categoryID uint) ([]domain.Work, error) {
|
|
ctx, span := q.tracer.Start(ctx, "FindWorksByCategory")
|
|
defer span.End()
|
|
if categoryID == 0 {
|
|
return nil, errors.New("invalid category ID")
|
|
}
|
|
return q.repo.FindByCategory(ctx, categoryID)
|
|
}
|
|
|
|
// FindWorksByLanguage finds works by language.
|
|
func (q *WorkQueries) FindWorksByLanguage(ctx context.Context, language string, page, pageSize int) (*domain.PaginatedResult[domain.Work], error) {
|
|
ctx, span := q.tracer.Start(ctx, "FindWorksByLanguage")
|
|
defer span.End()
|
|
if language == "" {
|
|
return nil, errors.New("language cannot be empty")
|
|
}
|
|
return q.repo.FindByLanguage(ctx, language, page, pageSize)
|
|
}
|
|
|
|
// ListByCollectionID finds works by collection ID.
|
|
func (q *WorkQueries) ListByCollectionID(ctx context.Context, collectionID uint) ([]domain.Work, error) {
|
|
ctx, span := q.tracer.Start(ctx, "ListByCollectionID")
|
|
defer span.End()
|
|
if collectionID == 0 {
|
|
return nil, errors.New("invalid collection ID")
|
|
}
|
|
return q.repo.ListByCollectionID(ctx, collectionID)
|
|
}
|