Go

Folder Structure

📁 infrastructure
│   📁 config
│   │   📄 .env.example
│   │   📄 config.go
│   📁 database
│       📄 database.go
📁 internal
│   📁 domain
│   │   📄 [...].domain.go
│   📁 dto
│   │   📄 [...].request.go
│   │   📄 [...].response.go
│   📁 handler
│   │   📄 [...].handler.go
│   📁 microservice
│   │   📄 [...].microservice.go
│   📁 model
│   │   📄 [...].model.go
│   📁 repository
│   │   📄 [...].repository.go
│   📁 usecase
│       📄 [...].usecase.go
📁 migrations
│   📄 [...].down.sql
│   📄 [...].up.sql
📁 routers
│   📄 init.routes.go
│   📄 [...].routes.go
📁 shared
│   📁 constants
│   │   📄 [...].constants.go
│   📁 enums
│   │   📄 [...].enums.go
│   📁 errors
│   │   📄 [...].errors.go
│   📁 middlewares
│   │   📄 [...].middleware.go
│   📁 response
│   │   📄 [...].response.go
│   📁 utils
│       📄 [...].utils.go
📁 third-party
│   📄 [...].thirdparty.go
📄 main.go
📄 go.mod
📄 go.sum
📄 .gitignore
📄 README.md
📄 Makefile

Folder Descriptions

infrastructure/

Manages external system integrations and configurations

config/ – Application configuration management (env parsing, server ports)
database/ – Database connection and management (init, pooling)

internal/

Core application logic (business-critical code, protected from external imports).

domain/
- Pure business logic and domain rules.
- Core business entities and domain rules
dto/ (Data transfer Objects)
- Define contracts for data exchange between layers.
- Request and response structures for API communication.
handler/
- HTTP request/response handling and routing
- Controllers that process incoming HTTP requests
microservice/
- Call other services under the same network
- Service orchestration and inter-service communication
model/
- Database model definitions and ORM mappings
- Data structures that map to database tables
repository/
- Data access layer implementing domain repository interfaces
- Abstract data storage operations
usecase/
- Implement business use cases and application workflows
- Application-specific business logic coordination
migrations/
- Database schema version control and evolution
- SQL migration files for database changes
routers/
- HTTP routing configuration and middleware setup
- Route definitions and middleware chain configuration
shared/

Cross-cutting concerns and utilities.

- :icon{class="size-5" name="i-ph:folder-simple"} **constants/**
    - Application-wide constant values, enum definitions, and configuration keys
    - e.g., HTTP status codes, error codes, default values, system limits
- :icon{class="size-5" name="i-ph:folder-simple"} **enums/**
    - Type-safe enumeration definitions
    - e.g., String conversion methods, validation functions, JSON marshaling
- :icon{class="size-5" name="i-ph:folder-simple"} **errors/**
    - Custom error types
    - e.g., Custom error types with error codes, Error wrapping and unwrapping utilities, Structured error responses
- :icon{class="size-5" name="i-ph:folder-simple"} **middlewares/**
    - Individual middleware functions
    - e.g., Authentication middleware, Authorization middleware, CORS middleware
    - e.g., Custom error types with error codes, Error wrapping and unwrapping utilities, Structured error responses
- :icon{class="size-5" name="i-ph:folder-simple"} **response/**
    - Success response formatters
    - e.g., Standardized API response structures, Error response formatting
- :icon{class="size-5" name="i-ph:folder-simple"} **utils/**
    - Utility functions
    - e.g., Date/time helpers, String manipulation utilities, Validation functions

third-party/

External service integrations and third-party API clients - e.g., Payment gateways, External APIs, and webhooks

main.go

Application entry point and initialization

go.mod

Dependency verification and integrity

go.sum

Version control exclusions

.gitignore

Version control exclusions

README.md

Project documentation and setup instructions

Makefile

Build automation and development tools

Nuxt

Text, title, and styling in standard markdown.