KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

Mini_Ecommerce_Clean

★ 22 Open GitHub ↗

E-Commerce mini system via Golang and React with Clean Architechture

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Go-Ecommerce-Clean Architecture](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/main.excalidraw.svg)

# Go-Ecommerce-Clean Architecture

## ⭐⭐⭐ Give Me Star

If this project is helpful to you, please consider giving it a star on GitHub. Contact with me if you have a question.

## Overview

The purpose of the template is to show:

- how to organize a project and prevent it from turning into spaghetti code
- where to store business logic so that it remains independent, clean, and extensible
- how not to lose control when a project grows

Using the principles of Robert Martin (aka Uncle Bob).

## Demo (Youtube)

[![Watch the demo](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/screeen.png)](https://www.youtube.com/watch?v=v5L2c1o0I7M)

## Clean Architecture

![Clean](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/clean.excalidraw.svg)

## Database

![Database](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/database.png)

## Clean Module

### User_Module

![UserModel](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/user_module.excalidraw.svg)

### Product_Module

![ProductModule](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/product_module.excalidraw.svg)

### Order_Module

![OrderModule](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/order_module.excalidraw.svg)

### Cart_Module

![OrderModule](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/cart_module.excalidraw.svg)

## Use Case

![UseCase](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/ecommerce_usecase.drawio.png)

## Tech Stack

![TechStack](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/techstack.excalidraw.svg)

- [React](https://react.dev)
- [Restful API](https://docs.github.com/en/rest?apiVersion=2022-11-28)
- [Domain Driven Design](https://flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartI/ConceptsOfModernProgramming.html)
- [Gin-gonic](https://github.com/gin-gonic/gin)
- [Gorm](https://github.com/go-gorm/gorm)
- [Swagger](https://github.com/swagger-api)
- [Logging](https://github.com/uber-go/zap)
- [Jwt-Go](https://github.com/golang-jwt/jwt)
- [Casbin](https://github.com/casbin/casbin)
- [Mailer](https://github.com/go-gomail/gomail)
- [Redis](https://github.com/redis/go-redis)
- [Minio](https://github.com/minio/minio-go)
- [Docker](https://www.docker.com/)
- [Nginx](https://nginx.org/)
- [Grafana](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-golang/)
- [Prometheus](https://github.com/prometheus/client_golang)

## Project Structure

![Project_Structure](https://raw.githubusercontent.com/eric-sfwe/Mini_Ecommerce_Clean/main/docs/static/project_structure.excalidraw.svg)

### `cmd/app`

Entry point of the application. Responsible for initializing the configuration, setting up the logger, and starting the application.

### `configs`

Contains configuration files for different environments, such as database connections, API keys, and other application settings.

### `db`

Holds database-related files, including database setup and option function.

### `frontend`

Setup client for demo project.

### `docs`

Contains documentation files, API specifications, and related documentation resources.

### `internals`

This directory houses the core business logic of the application, divided into multiples modules

### `nginx`

Stores configuration files for Nginx

### `pkgs`

Contains reusable packages and utilities that can be shared across different parts of the project.

### `utils`

Includes utility functions and helper methods used throughout the project.

### `grafana`

Contains configuration files and dashboards for monitoring application metrics using Grafana.

### `prometheus`

Holds configuration files for Prometheus, which collects and stores metrics from the application for monitoring and alerting.

## How to run application with Docker (Recommend)

1. Clone the repo and cd into it
2. Set mode `LF` (not `CRLF`) for entrypoint.sh file
3. Copy `.example.env` (not `app.example.env`) file to `.env` file and update your `env variables`
4. Run `docker-compose up --build -d` local dev environment
5. Setup minio container.

- Run `docker exec -it <container_id of ecommerce.minio> sh`.
- Run `mc alias set myminio http://ecommerce.minio:9000 minioadmin minioadmin123`.
- Run `mc anonymous set public myminio/ecommerce`.

6. Test api with BASE_URL is `http://localhost:8080/api/v1` or `http://app.lvh.me/api/v1`
7. If you want to demo with Frontend on React, visit `http://localhost:8005` on browser.

## Reference projects

- [https://github.com/evrone/go-clean-template](https://github.com/evrone/go-clean-template)
- [https://github.com/bxcodec/go-clean-arch](https://github.com/bxcodec/go-clean-arch)

## Useful links

- [The Clean Architecture article](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
- [Twelve factors](https://12factor.net/ru/)

## Author Contact

Contact me with any questions!<br>

Email: anquoc18092003@gmail.com
Facebook: https://www.facebook.com/tranphuocanhquoc2003

<p style="text-align:center">Thank You so much for your time !!!</p>

Mini_Ecommerce_Clean

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README