khannedy/golang-clean-architecture
Golang Clean Architecture
This project provides a structured boilerplate for building Go web applications based on clean architecture principles. It serves as a template for organizing codebases to ensure that core business logic remains isolated from external frameworks, database layers, and delivery mechanisms.
The implementation prioritizes domain-driven design by centering the application around pure business entities that contain no references to infrastructure concerns. It utilizes layered dependency inversion and interface-based port adaptation to decouple the internal logic from external dependencies, allowing for independent evolution of the system components.
The framework includes integrated support for managing application behavior through external environment-variable configuration and handles database evolution via versioned schema migration scripts. It also incorporates an asynchronous worker pattern to execute background tasks independently of the primary request lifecycle, ensuring that long-running operations do not block incoming network traffic.
Features
- Go Clean Architecture Templates - Offers a foundational template for building Go applications that strictly decouple business logic from infrastructure layers.
- Core Business Logic - Isolates core business rules from external frameworks and storage layers.
- Clean Architecture Implementations - Structures Go applications into isolated layers to decouple business logic from infrastructure.
- Domain-Driven Designs - Prioritizes core business rules and domain entities over infrastructure concerns.
- Domain Driven Frameworks - Implements domain-driven design patterns to prioritize business rules in Go development.
- Go and Ruby Boilerplates - Provides a structured starter kit for organizing Go web applications using clean architecture principles.
- Background Task Execution - Handles long-running operations in the background to maintain system responsiveness.
- Asynchronous Execution Patterns - Executes background tasks asynchronously to prevent blocking the primary request lifecycle.
- Asynchronous Task Processing - Offloads non-critical operations to background workers to ensure system responsiveness.
- Database Schema Migrations - Maintains database consistency across environments using versioned schema migration scripts.
- Database Migration Tools - Provides utilities for versioning and applying incremental schema changes to database structures.
- Business Entities - Encapsulates core business rules in pure data structures independent of infrastructure.
- Dependency Inversion Patterns - Ensures high-level business logic depends on abstractions rather than concrete infrastructure implementations.
- Ports and Adapters - Decouples internal business logic from external delivery mechanisms using interface-based ports.
- Routing and Request Handling - Maps incoming network traffic to specific business logic handlers.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
