golang clean architecture v2

[martinyonatann]

🏗️ Architecture Enhancement & API Documentation

📋 What's Changed

🔄 Mapper Hierarchy Refactoring

• Moved mappers to top-level architecture following Clean Architecture principles
• Bottom layers no longer depend on top-layer types
• Improved separation of concerns and reduced coupling

📚 Swagger Documentation

• Added complete OpenAPI 2.0 specification
• Interactive API explorer available at /swagger/
• Auto-generated docs with request/response schemas

🎯 Design Patterns

Option Pattern

// Flexible User Detail
func(r *repository) UserDetail(ctx context.Context, opts ...entities.UserDetailOption) (user entities.User, err error)

Factory Method Pattern

type UserDetailRequest interface {
    ToUserDetailOption() entities.UserDetailOption
}

// Polymorphic request handling
func GetUserDetail(req UserDetailRequest) {
    option := req.ToUserDetailOption()
    return userService.GetDetail(option)
}

✅ Benefits

• Cleaner Dependencies: Better architecture hierarchy
• Better Documentation: Interactive API docs
• Flexible APIs: Option pattern for backward compatibility
• Extensible Code: Easy to add new request types

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud