Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rahugg/crm-system-go-microservices
Customer Relationship Management helps to manage tasks, assign deadlines, control user roles, use of admin panel, feedback management, sales representation, deal management
https://github.com/rahugg/crm-system-go-microservices
crm-system golang grpc kafka microservices-architecture swagger
Last synced: 2 months ago
JSON representation
Customer Relationship Management helps to manage tasks, assign deadlines, control user roles, use of admin panel, feedback management, sales representation, deal management
- Host: GitHub
- URL: https://github.com/rahugg/crm-system-go-microservices
- Owner: Rahugg
- License: mit
- Created: 2023-09-29T09:10:52.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-06-06T05:13:35.000Z (8 months ago)
- Last Synced: 2024-06-06T06:33:38.105Z (8 months ago)
- Topics: crm-system, golang, grpc, kafka, microservices-architecture, swagger
- Language: Go
- Homepage:
- Size: 1.65 MB
- Stars: 14
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![MIT License][license-shield]][license-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
CRM-system-go-microservices
Simple Customer Relationship Management helps to manage tasks, assign deadlines, control user roles, use of admin panel, feedback management, sales representation, deal management
Table of Contents
-
About The Project
-
Architecture of project
-
Detailed Architecture
-
Getting started
-
Contact
-
Reasons of using these Technologies
## About The Project
Customer Relationship Management
### My application's features:
- Assign deadlines
- Contact management
- Control user roles
- Deal management
- Feedback management
- Helps to manage tasks
- Monitor the metrics
- Sales representation
- Use of admin panel
## Built With
* [![Golang][Golang-badge]][Golang-url]
* [![Gin][Gin-badge]][Gin-url]
* [![gRPC][gRPC-badge]][gRPC-url]
* [![PostgreSQL][PostgreSQL-badge]][PostgreSQL-url]
* [![Redis][Redis-badge]][Redis-url]
* [![Kafka][Kafka-badge]][Kafka-url]
* [![Docker][Docker-badge]][Docker-url]
* [![Swagger][Swagger-badge]][Swagger-url]
* [![Grafana][Grafana-badge]][Grafana-url]
* [![Prometheus][Prometheus-badge]][Prometheus-url]
## Tech features
* Concurrency
* Design Patterns
* Docker
* gRPC
* JWT Auth
* Kafka
* Linters
* Migrations
* Metrics Grafana/Prometheus
* Middleware
* PostgreSQL
* Redis
* RESTful APIs
* Swagger
* Viper Config
## Folder Structure
## Internal
### `app`
Main application logic and resource management.
### `controller`
HTTP and/or gRPC controllers for request handling.
### `docs`
Internal documentation.
### `entity`
Data structures representing domain entities.
### `repository`
Data access methods for persistence and retrieval.
### `service`
Encapsulated business logic.
### `storage`
Interaction with specific data storage systems.
## Cmd
### `auth`
Entry point for the authentication service.
### `crm_core`
Entry point for the core CRM service.
## Config
### `auth`
Configuration specific to the authentication service.
### `crm_core`
Configuration specific to the core CRM service.
## Data
### `kafka1`
Data for the Kafka service (topics, messages).
### `zookeeper`
Configuration files and state information for Zookeeper.
## Migrations
### `auth`
Database schema migration scripts for the authentication service.
### `crm_core`
Database schema migration scripts for the core CRM service.
## Pkg
### `auth`
Reusable functions and utilities specific to the authentication service.
### `crm_core`
Reusable functions and utilities specific to the core CRM service.
## Reasons why I used these technologies
Technologies
-
Golang
I used Golang as a main backend language. And I wrote a backend by using Gin framework, It was easy to learn and write code in it, and Golang helped me to deal with concurrency.
Features where I used concurrency:
* Graceful Shutdown
* Kafka producer-consumer relation
* User confirm.
* In-memory caching
-
PostgreSQL
As a main database storage. Because of their open-source and availability, I preffered to use this database. Relational Database helped me to build relations among the entities, and it helped
to build an application structured around a relationship between data tables.
-
Redis
As a NoSQL database, I used Redis to cache the most used and unchanged data, and this helped me to retrieve the data faster.
This provides improved read performance (as requests can be split among the servers) and faster recovery when the primary server experiences an outage
-
Kafka
I used Kafka as a message broker. Because Kafka streams messages with very low latency and is suitable to analyze streaming data in real time.
It can be used as a monitoring service to raise alerts and etc.
Kafka is suitable for my app that need to reanalyze the received data
-
gRPC
gRPC uses a binary format for data serialization and communication, which is much more efficient than traditional text-based formats such as JSON or XML.
This results in faster and more efficient communication between microservices.
-
Docker
Docker helps to containerize the application which can help to easy-sharing among the users and by installing some dependencies such as Redis and Kafka to project.
Docker lets you build, test, and deploy applications quickly
Because Docker containers encapsulate everything an application needs to run (and only those things), they allow applications to be shuttled easily between environments.
-
Swagger
Swagger allowed me to describe the structure of my APIs so that machines can read them. The ability of APIs to describe their own structure is the root of all awesomeness in Swagger.
-
Grafana
Grafana helps me to visualize the data and monitor the proccess of my app, I collect the metrics from Prometheus and visualizing them in Grafana on localhost:3000
-
Prometheus
Prometheus can collect and store metrics as time-series data, recording information with a timestamp, and I am visualizing them in Grafana
## Getting Started
## Installation
2. Clone the repo
```sh
git clone https://github.com/Rahugg/CRM-system-go-microservices.git
```
3. Install go packages
```sh
go mod tidy
```
4. Launch docker-compose
```
docker-compose up
```
## Launch
1. To launch the auth-service: (make sure that the docker-compose is up)
```
make start-auth
```
(Check makefile for other scripts)
2. To launch the crm_core service: (make sure that the docker-compose is up)
```
make start-crm
```
(Check makefile for other scripts)
## Migrate
1. To migrate the data and tables on services:(Check makefile for other scripts)
```
make migrate-up
```
2. To mock the database with mock data:(Check makefile for other scripts)
```
make mock-data
```
3. To drop all of the tables:
```
make migrate-down
```
## [Architecture of project](pkg/crm_core/img/architecture-of-project.png)
## [Detailed](pkg/crm_core/img/detailed-architecture.png)
## Contact
Amanbek - [@telegram_handle](https://t.me/Rahuggg) - Rahuggg
Project Link: [https://github.com/Rahugg/CRM-system-go-microservices](https://github.com/Rahugg/CRM-system-go-microservices)
[forks-shield]: https://img.shields.io/github/forks/Rahugg/CRM-system-go-microservices.svg?style=for-the-badge
[forks-url]: https://github.com/Rahugg/CRM-system-go-microservices/network/members
[stars-shield]: https://img.shields.io/github/stars/Rahugg/CRM-system-go-microservices.svg?style=for-the-badge
[stars-url]: https://github.com/Rahugg/CRM-system-go-microservices/stargazers
[license-shield]: https://img.shields.io/badge/license-MIT-blue
[license-url]: https://github.com/Rahugg/CRM-system-go-microservices/blob/master/LICENSE
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/amanbek-faizolla
[Golang-badge]: https://img.shields.io/badge/Go-00ADD8?style=for-the-badge&logo=go&logoColor=white
[Golang-url]: https://golang.org/
[Gin-badge]: https://img.shields.io/badge/Gin-00ADD8?style=for-the-badge&logo=go&logoColor=white
[Gin-url]: https://gin-gonic.com/
[PostgreSQL-badge]: https://img.shields.io/badge/PostgreSQL-336791?style=for-the-badge&logo=postgresql&logoColor=white
[PostgreSQL-url]: https://www.postgresql.org/
[Redis-badge]: https://img.shields.io/badge/Redis-DC382D?style=for-the-badge&logo=redis&logoColor=white
[Redis-url]: https://redis.io/
[Kafka-badge]: https://img.shields.io/badge/Apache%20Kafka-231F20?style=for-the-badge&logo=apache-kafka&logoColor=white
[Kafka-url]: https://kafka.apache.org/
[gRPC-badge]: https://img.shields.io/badge/gRPC-00ADD8?style=for-the-badge&logo=go&logoColor=white
[gRPC-url]: https://grpc.io/
[Docker-badge]: https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white
[Docker-url]: https://www.docker.com/
[Swagger-badge]: https://img.shields.io/badge/Swagger-85EA2D?style=for-the-badge&logo=swagger&logoColor=black
[Swagger-url]: https://swagger.io/
[Grafana-badge]: https://img.shields.io/badge/Grafana-F46800?style=for-the-badge&logo=grafana&logoColor=white
[Grafana-url]: https://grafana.com/
[Prometheus-badge]: https://img.shields.io/badge/Prometheus-E6522C?style=for-the-badge&logo=prometheus&logoColor=white
[Prometheus-url]: https://prometheus.io/