# amitshekhariitbhu/go-backend-clean-architecture

A Go (Golang) Backend Clean Architecture project with Gin, MongoDB, JWT Authentication Middleware, Test, and Docker.

Repository: https://github.com/amitshekhariitbhu/go-backend-clean-architecture
Canonical: https://ross.abutalabs.com/products/go-backend-clean-architecture
Homepage: https://outcomeschool.com/blog/go-backend-clean-architecture
Language: Go
License: Apache-2.0
License Family: permissive
Topics: architecture, backend, clean-architecture, gin, go, golang, jwt-authentication, project, project-template, docker, test, api
Last push: 2026-02-05T09:10:04+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 66, release rhythm 35, longevity 95
- inputs: {"age_days": 1333, "days_push": 209, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6145, forks 673 (observed 2026-08-28T04:09:36.545593+00:00)

## What it is
A Go backend project template implementing clean architecture with layered structure (Router, Controller, Usecase, Repository, Domain). It ships with Gin, MongoDB, JWT authentication middleware, tests, and Docker setup.

## Use cases
- start a new Go backend project with clean architecture
- learn how to structure a Gin and MongoDB backend
- add JWT authentication middleware in Go
- see how to test Go backend with Testify and Mockery
- dockerize a Go REST API backend
- understand controller-usecase-repository layering in Go

## When to choose
- you want a well-structured starting template for a Go REST API
- you want to study clean architecture applied to Go backends
- you need JWT auth, MongoDB, and Docker wired up out of the box

## When to avoid
- you need a production system with different databases or frameworks than Gin/MongoDB
- you prefer minimal scaffolding or a different architectural style
- you need a full application rather than a template

## Facets
- artifact type: learning-resource
- maturity: active
- function: web-framework, auth, middleware, testing, api-framework
- domain: backend, web-development, developer-tools, apis
- platform: go, cli
- tags: clean-architecture, gin, mongodb, jwt, project-template, boilerplate, rest-api, boilerplate, docker

## Member repositories
- amitshekhariitbhu/go-backend-clean-architecture (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:36.545593+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:31:20.724670+00:00, confidence not recorded.
  - readme: https://github.com/amitshekhariitbhu/go-backend-clean-architecture (fetched 2026-08-28T04:09:36.545593+00:00, sha 23b183cfa3c6)
  - homepage: https://outcomeschool.com/blog/go-backend-clean-architecture (fetched 2026-08-29T08:44:21.800407+00:00, sha d46d363631db)
- Data as of 2026-08-30T08:39:29.467469+00:00.